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

> Connect Slack and route channels to Aether projects as tasks

Manage the Slack integration. Connect your Slack workspace, then create routes that map a Slack channel to an Aether project. Messages in a routed channel spawn Aether tasks, and task updates post back to the channel thread.

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

## Usage

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

## Subcommands

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

## aether slack connect

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

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

```
Opening browser to connect Slack...

  Authorize Aether to access your Slack workspace.
  Waiting for connection...

Slack connected (workspace: My Team).
```

## aether slack status

Show whether Slack is connected and the connected workspace.

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

```
Slack: connected
  Workspace: My Team
  Team ID:   T012AB3CD
```

## aether slack channels

List Slack channels visible to the app. The output lists `ID`, `NAME`, and `PRIVATE`.

```bash theme={null}
aether slack channels
```

## aether slack routes list

List Slack routes. The output lists `ID`, `CHANNEL`, `AETHER PROJECT`, and `ENABLED`.

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

## aether slack routes create

Create a route mapping a Slack channel to an Aether project. Omit the channel flags to pick a channel interactively. Omit `--aether-project` to use your selected project. The Aether project must have a linked GitHub repository.

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

| Flag               | Description                                                                                      |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| `--channel-id`     | Slack channel ID. Must be passed together with `--channel-name`; omit both to pick interactively |
| `--channel-name`   | Slack channel name. Must be passed together with `--channel-id`                                  |
| `--private`        | Mark the channel as private when using `--channel-id`/`--channel-name`                           |
| `--aether-project` | Aether project ID or prefix. Defaults to your selected project                                   |
| `--enabled`        | Enable the route, `true` or `false` (default `true`)                                             |

Run `aether slack channels` to look up channel IDs.

```bash theme={null}
aether slack routes create --channel-id C012AB3CD --channel-name eng --aether-project a1b2c3d4
```

```
Created Slack route 9f8e7d6c for #eng -> project a1b2c3d4.
```

## aether slack routes update

Enable or disable a route.

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

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

## aether slack routes delete

Delete a Slack route.

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

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

## aether slack disconnect

Disconnect Slack. This removes all Slack routes.

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

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