> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear Integration

> Connect Linear so issues route to Aether projects as tasks and results post back as Linear comments.

Connect Linear to turn issues into Aether tasks. You create **routes** that map a Linear team — optionally a specific project within it — to an Aether [project](/guides/projects). Matching issues open tasks in that project, and the agent's progress and result post back to Linear.

<Note>
  Linear is **config-gated**: it is only available when the deployment has Linear OAuth credentials configured. If you do not see Linear in **Settings → Connections** or the CLI commands return errors, the deployment has not enabled it. See [Integrations](/guides/integrations).
</Note>

## Prerequisites

A route targets an Aether project that has a **linked GitHub repo** — that is where the agent's work lands. Connect GitHub and import a repo first; see [GitHub integration](/guides/github-integration).

## Connecting Linear

<Tabs>
  <Tab title="Web">
    Go to **Settings → Connections → Linear** and click **Connect** to authorize Aether to access your Linear organization.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    aether linear connect
    ```

    This opens your browser to authorize Aether, then polls until the connection completes. On success it prints the connected organization.
  </Tab>
</Tabs>

Check the connection any time:

```bash theme={null}
aether linear status
```

## Listing Teams and Projects

Routes are keyed by Linear team and (optionally) project ID, so look those up first:

```bash theme={null}
# Teams in the connected org
aether linear teams

# Projects in a team
aether linear projects --team-id <linear-team-id>
```

## Creating a Route

A route maps a Linear team (and optionally one project within it) to an Aether project. Omit the Linear project to match every issue in the team.

```bash theme={null}
# Route all of a team's issues to the selected Aether project
aether linear routes create --team-id <linear-team-id>

# Scope to one Linear project, and target a specific Aether project
aether linear routes create \
  --team-id <linear-team-id> \
  --linear-project-id <linear-project-id> \
  --aether-project a1b2c3d4
```

Run with no flags to pick the team interactively. `--aether-project` accepts a project ID or short prefix and defaults to your [selected project](/guides/projects); it must be a project with a linked repo. New routes are enabled by default — pass `--enabled false` to create one paused.

## What Happens on an Issue

When a matching Linear issue triggers Aether, the agent opens a task seeded from the issue's identifier, title, description, labels, and recent comments, with instructions to implement the fix, run checks, and open or update a PR. Progress and the final result post back to the Linear issue as comments and agent-session activities, including links to the Aether task and the pull request.

## Managing Routes

```bash theme={null}
# List routes (team, Linear project, Aether project, enabled)
aether linear routes list

# Pause or resume a route
aether linear routes update <route-id> --enabled false
aether linear routes update <route-id> --enabled true

# Delete a route
aether linear routes delete <route-id> --force
```

The `enabled` flag lets you pause a route without deleting it.

## Disconnecting Linear

```bash theme={null}
aether linear disconnect --force
```

<Warning>
  Disconnecting removes all Linear routes. `--force` skips the confirmation prompt.
</Warning>

## API

The Linear endpoints are part of the frontend/CLI API surface, not the versioned `/v1` API, and are config-gated — see the [API overview](/api-reference/overview). Browse the operations under the Linear group, for example [list routes](/api-reference/account/linear/get-linear-routes) and [create a route](/api-reference/account/linear/post-linear-routes). The full CLI reference is at [`aether linear`](/cli/linear).