> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aosplane.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aosplane.io/_mcp/server.

# Slack

Add AOSplane to your Slack workspace, and anyone on your team can tag **@AOSplane** with a task or a screenshot to start a session. The session runs as them, and its progress, answers and pull request land in the same thread.

> **Note**
>
> Slack comes with the Starter, Team and Enterprise plans. Owners and Admins connect and manage it.

## Connect Slack

#### Open the Slack page

Open **Settings** › **Connections** and choose **Connect** next to **Slack** under **Chat**.

#### Authorize the workspace

Choose **Add to Slack** and approve AOSplane in Slack.

#### Invite AOSplane to a channel

In Slack, type `/invite @AOSplane` in a channel.

#### Try it

Tag **@AOSplane** there with a task to start a session.

![Slack settings page with the connected workspace, the Channels and Workspace tabs, the Channel defaults list and How Slack picks a project](/_fern-files/_img/ad2fe56c2b1c403e4b5f936fd7dcf883452f99e9078f55826dbf4ac3ac5c15a7.webp)

Nobody links an account by hand. AOSplane recognizes each person by the verified email on their Slack account, and they keep their own role and project access.

## Start a session from Slack

#### Ask

Tag **@AOSplane** in a channel with what you need, and paste screenshots if they help. You can also message AOSplane directly, or use the **Start AOSplane session** shortcut on any message.

#### Pick the repository

AOSplane posts a card in the thread. Pick a repository from **Choose a repository**, then choose **Start in** followed by its name. The card skips this when your message names one repository, your organization has only one, or the thread's last session used one.

#### Follow along

The card shows the agent's plan as it works, with **Open session** to watch in AOSplane. Each finished turn posts the agent's answer in the thread, and the end posts the pull request link.

#### Steer or stop

Reply in the thread, no tag needed, to steer the session. Choose **Stop** on the card to end it.

When you share images with a tag, the card asks what to do: **New session**, **Add to a session** (one already running in that channel) or **New channel**, which moves the request into a new private channel with the people from the thread.

## Set a channel default (optional)

A session runs in the project its repository belongs to. Other conversations, like questions, use the channel's default project, or your organization's oldest project if there's none.

#### Open Channels

On the Slack page, choose the **Channels** tab, then **New channel default**.

#### Choose a channel and project

Pick the channel (AOSplane must be a member) and the project. Optionally pick an agent and environment.

#### Choose what it may do

Set **Notifications** to **Terminal only**, **Milestones** or **All activity**, and turn **Human questions**, **Delegation** and **Intervention** on or off.

#### Save and test

Choose **Create channel default**. It starts as **Test required**; choose **Test** on its row to send a test message and start delivering.

## Good to know

* A session starts only in a repository the person who asked can write to on GitHub, and it runs as them.
* Each request is its own session, with its own sandbox, branch and pull request.
* `@AOSplane remember …` saves a note every session in the project uses. See [Memory](/memory).
* AOSplane only reads and posts in channels it's invited to.
* If the page asks you to **Update permissions**, approve them in Slack so AOSplane can recognize people, read screenshots and open private channels.
* To disconnect, open the **Workspace** tab and choose **Disconnect** under **Danger zone**. Channel defaults are kept, so reconnecting restores them.

## Related

* [Start a session](/start-a-session)
* [Repositories](/repositories)
* [Memory](/memory)