Slack Integration

Connect Slack to start tasks from chat. You create routes that map a Slack channel to an Aether project. 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.

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.

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.

Connecting Slack

Go to Settings → Connections → Slack and click Connect to authorize Aether for your Slack workspace.

aether slack connect

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

Check the connection any time:

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:

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.

# 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; 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 as Slack DMs.

Managing Routes

# 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

aether slack disconnect --force

Disconnecting removes all Slack routes. --force skips the confirmation prompt.

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. Browse the operations under the Slack group, for example list routes and create a route. The full CLI reference is at aether slack.

Getting Started

Using Aether

Slack Integration

Prerequisites

Connecting Slack

Listing Channels

Creating a Route

Starting Tasks from Slack

Managing Routes

Disconnecting Slack

API

​Prerequisites

​Connecting Slack

​Listing Channels

​Creating a Route

​Starting Tasks from Slack

​Managing Routes

​Disconnecting Slack

​API

Prerequisites

Connecting Slack

Listing Channels

Creating a Route

Starting Tasks from Slack

Managing Routes

Disconnecting Slack

API