> ## 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.

# aether linear

> Connect Linear and route issues to Aether projects as tasks

Manage the Linear integration. Connect your Linear organization, then create routes that map a Linear team (optionally a specific Linear project) to an Aether project. Matching Linear issues spawn Aether tasks, and results post back to the issue as comments.

<Note>
  The Linear integration is available only when the deployment is configured with Linear OAuth credentials. If `aether linear connect` reports the integration is unavailable, it is not enabled in your deployment.
</Note>

## Usage

```bash theme={null}
aether linear <subcommand> [flags]
```

## Subcommands

| Subcommand           | Description                                            |
| -------------------- | ------------------------------------------------------ |
| `connect`            | Connect your Linear organization                       |
| `disconnect`         | Disconnect Linear and remove all routes                |
| `status`             | Show connection status                                 |
| `teams`              | List Linear teams                                      |
| `projects`           | List Linear projects                                   |
| `routes list`        | List Linear routes                                     |
| `routes create`      | Create a route from a Linear team to an Aether project |
| `routes update <id>` | Enable or disable a route                              |
| `routes delete <id>` | Delete a route                                         |

## aether linear connect

Opens your browser for OAuth authorization, then polls until connected (up to 5 minutes). If Linear is already connected, it prints the organization and exits.

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

```
Opening browser to connect Linear...

  Authorize Aether to access your Linear organization.
  Waiting for connection...

Linear connected (organization: My Org).
```

## aether linear status

Show whether Linear is connected and the connected organization.

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

```
Linear: connected
  Organization: My Org
  ID:           org_12345
```

## aether linear teams

List Linear teams in the connected organization. The output lists `ID`, `KEY`, and `NAME`.

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

## aether linear projects

List Linear projects. The output lists `ID`, `TEAM`, and `NAME`.

```bash theme={null}
aether linear projects [flags]
```

| Flag        | Description                       |
| ----------- | --------------------------------- |
| `--team-id` | Filter projects by Linear team ID |

## aether linear routes list

List Linear routes. The output lists `ID`, `TEAM`, `LINEAR PROJECT` (`all` when the route covers the whole team), `AETHER PROJECT`, and `ENABLED`.

```bash theme={null}
aether linear routes list
```

## aether linear routes create

Create a route mapping a Linear team to an Aether project. Omit `--team-id` to pick a team interactively. Omit `--aether-project` to use your selected project. The Aether project must have a linked GitHub repository.

```bash theme={null}
aether linear routes create
```

| Flag                  | Description                                                                          |
| --------------------- | ------------------------------------------------------------------------------------ |
| `--team-id`           | Linear team ID. Omit to pick interactively (run `aether linear teams` to look it up) |
| `--linear-project-id` | Optional Linear project ID. Omit to cover all projects in the team                   |
| `--aether-project`    | Aether project ID or prefix. Defaults to your selected project                       |
| `--enabled`           | Enable the route, `true` or `false` (default `true`)                                 |

```bash theme={null}
aether linear routes create --team-id TEAM_123 --aether-project a1b2c3d4 --enabled true
```

```
Created Linear route 9f8e7d6c for team Backend -> project a1b2c3d4.
```

## aether linear routes update

Enable or disable a route.

```bash theme={null}
aether linear routes update <id> --enabled false
```

| Flag        | Description                      |
| ----------- | -------------------------------- |
| `--enabled` | `true` or `false` (**required**) |

## aether linear routes delete

Delete a Linear route.

```bash theme={null}
aether linear routes delete <id> [flags]
```

| Flag      | Description                  |
| --------- | ---------------------------- |
| `--force` | Skip the confirmation prompt |

## aether linear disconnect

Disconnect Linear. This removes all Linear routes.

```bash theme={null}
aether linear disconnect [flags]
```

| Flag      | Description                  |
| --------- | ---------------------------- |
| `--force` | Skip the confirmation prompt |