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

# Slack Integration

> Connect Slack so channel messages route to Aether projects as tasks and updates post back to the thread.

Connect Slack to start tasks from chat. You create **routes** that map a Slack channel to an Aether [project](/guides/projects). A message in a routed channel opens a task, and the agent's updates post back to that message's thread. Slack can also deliver your task notifications as direct messages.

<Note>
  Slack is **config-gated**: it is only available when the deployment has Slack OAuth credentials configured. If you do not see Slack 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 Slack

<Tabs>
  <Tab title="Web">
    Go to **Settings → Connections → Slack** and click **Connect** to authorize Aether for your Slack workspace.
  </Tab>

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

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

Check the connection any time:

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

Status reports the connected workspace and team ID, plus whether direct-message notifications are wired up for your Slack user.

## Listing Channels

Routes are keyed by channel, so look them up first:

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

This lists channels the Aether app can see, with their IDs and whether each is private.

## Creating a Route

A route maps a Slack channel to an Aether project.

```bash theme={null}
# Pick a channel interactively, route to the selected Aether project
aether slack routes create

# Specify the channel explicitly and target a project
aether slack routes create \
  --channel-id <channel-id> \
  --channel-name <channel-name> \
  --aether-project a1b2c3d4
```

`--channel-id` and `--channel-name` must be provided together; omit both to pick a channel interactively. Add `--private` when supplying a private channel by ID. `--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.

## Starting Tasks from Slack

In a routed channel, post a message mentioning **@Aether** to start a task. Aether replies in that message's thread and posts its progress, result, project, task link, and PR link there as the task runs. Reply **`cancel`**, **`stop`**, or **`abort`** in the thread to cancel the task.

If your Slack user's direct messages are wired up (shown by `aether slack status`), Aether can also deliver your [task notifications](/concepts/automation) as Slack DMs.

## Managing Routes

```bash theme={null}
# List routes (channel, Aether project, enabled)
aether slack routes list

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

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

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

## Disconnecting Slack

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

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

## API

The Slack 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 Slack group, for example [list routes](/api-reference/account/slack/get-slack-routes) and [create a route](/api-reference/account/slack/post-slack-routes). The full CLI reference is at [`aether slack`](/cli/slack).