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

# Integrations

> How Aether connects to GitHub, Sentry, Linear, and Slack, and how integration events spawn tasks.

Aether integrates with four third-party services. Connecting one authorizes Aether to read from it and, for Sentry, Linear, and Slack, to **spawn tasks** in response to events from it. Each connection is per user and is managed from the dashboard or the CLI.

## What connecting does

| Integration | What connecting authorizes                                                                                              | What it can trigger                                                                                                          |
| ----------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| GitHub      | Installs the Aether GitHub App so Aether can read repos, import them into projects, push changes, and receive webhooks. | PR reviews, CI auto-fix, auto-rebase, and PR-comment follow-ups (see [Automation](/concepts/automation)).                    |
| Sentry      | OAuth into your Sentry org so Aether can list projects and receive new-error events.                                    | An auto-fix task when a linked Sentry project reports a new error.                                                           |
| Linear      | OAuth into your Linear org so Aether can list teams and projects and receive issue events.                              | A task when a Linear issue matches a route; the result is posted back as a Linear comment.                                   |
| Slack       | OAuth into your Slack workspace so Aether can list channels and receive messages and slash commands.                    | A task when a message lands in a routed channel; updates post back to the thread. Slack DMs can also be a notification sink. |

GitHub is the foundation — Sentry, Linear, and Slack routes all target an Aether project that has a **linked GitHub repo**, since that is where the agent's work lands.

## Routes spawn tasks

Sentry, Linear, and Slack share the same model: you create **routes** mapping a source object to an Aether project, and matching events spawn tasks in that project.

* **Sentry links** map a Sentry project to a GitHub repo and target branch, with an optional auto-fix flag. A new error in a linked project opens a fix task.
* **Linear routes** map a Linear team (optionally a specific project within it) to an Aether project. Matching issues open tasks; results return as Linear comments.
* **Slack routes** map a Slack channel to an Aether project. Messages in routed channels open tasks; task updates publish back to the Slack thread.

Each route has an enabled flag so you can pause it without deleting it. Manage routes from the CLI (`aether sentry`, `aether linear`, `aether slack`) or the dashboard.

## Availability is config-gated

GitHub is always available. **Sentry, Linear, and Slack are only available when the deployment has the corresponding OAuth credentials configured.** If those credentials are unset, the integration is absent entirely — its connect flow, routes, and webhooks are not registered. If you do not see one of these integrations, the deployment you are on has not enabled it.

<Note>
  Integration endpoints are part of the frontend/CLI API surface, not the versioned public `/v1` API. See the [API overview](/api-reference/overview) for the distinction.
</Note>

## Connecting

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="/guides/github-integration">
    Install the GitHub App, import a repo, and push changes.
  </Card>

  <Card title="Linear" icon="list-check" href="/guides/linear-integration">
    Connect Linear and route issues to Aether projects.
  </Card>

  <Card title="Slack" icon="slack" href="/guides/slack-integration">
    Connect Slack and route channels to Aether projects.
  </Card>

  <Card title="All integrations" icon="plug" href="/guides/integrations">
    Overview of every connection and how to manage them.
  </Card>
</CardGroup>