Slack
Overview
Connect Slack to start Capy threads directly from messages, sync conversations, and let agents read and search your Slack workspace for context.
For an overview of working with Capy from Slack, see Capy for Slack.
Installing the Slack app
The Connect Slack button that adds Capy to Slack is in Capy's settings, so you sign in to Capy first. Any member of your Capy organization can install and authorize Capy from Slack settings. The connection applies to your entire organization. The default project handles DMs and channels without an explicit mapping.
Sign up for Capy
Go to capy.ai and sign up, or sign in if you already have an account.
Name your organization
Capy creates an organization for you during setup. Enter a Workspace name and click Continue. If a teammate invited you, accept the invitation to join their organization instead.
Connect GitHub
Click Connect GitHub, install the Capy GitHub App, and choose the repositories Capy can access. See GitHub.
Connect Slack
Open Settings → Integrations → Slack and click Connect Slack. Slack opens its install page for your workspace. Review the permissions and click Allow.
Link your Slack account
On the same page, click Link account next to Personal Slack account, so the threads you start from Slack belong to you. Capy also links you automatically when your Slack email matches your Capy email, and sends you a link prompt when you mention @Capy in Slack.
Optional: read Slack as you
Next to Read Slack as you, click Connect and approve the read-only permissions in Slack. Capy can then read a conversation the Capy app isn't in, after you approve it in the thread. See Permissions.
To start, mention @Capy in a channel. If Capy doesn't respond, type /invite @Capy in that channel first.


Note
A paid Slack plan is required to access AI assistant features, such as Capy in Slack's agent panel. Mentions, direct messages, and the Ask with Capy shortcut work on every Slack plan.
Starting threads from Slack
Mention @Capy in any channel where the app is installed. Capy starts a thread from your message and responds in a Slack thread. You can continue the conversation there - messages are synced to the Capy thread.
You can also share images and files in the message. Capy will pick them up as context for the thread.
Thread controls
Use thread controls to manage what Capy sees and when it responds inside a Slack thread. Type help, !help, or @Capy help to see every shortcut and command in a message only you can see.
Aside messages
Prefix a message with aside (or its alias !aside) to exclude it from Capy's processing entirely.
- Capy won't see the message
- Capy won't respond to it
- It won't appear in the agent's context when Capy reads thread history
This works with aside ... and @Capy aside .... The check is case-insensitive, and aside must be at the start of the message.
Tip
aside when you want to talk with teammates in a Capy thread without the agent picking those messages up.Mute and unmute
Mute a thread to stop Capy from responding to regular thread replies.
- Type
mute,!mute, or@Capy mutein the thread to mute it - Type
unmute,!unmute, or@Capy unmuteto turn replies back on - When muted, Capy ignores regular thread replies
- Direct
@Capymentions still go through - DMs still work
Capy confirms the change with an ephemeral message visible only to you:
Thread muted - Capy will ignore messages here unless directly mentioned with @Capy.Thread unmuted - Capy will respond to messages in this thread again.
If the thread is already in the requested state, Capy does nothing. Mute state is stored per thread.
Archive
Archive a Slack thread to stop Capy and close the Capy thread.
- Type
archive,!archive, or@Capy archivein the thread - Capy stops any running work and archives the Capy thread
- Later messages and direct mentions in the archived Slack thread are ignored and do not unarchive it
- Type
unarchive,!unarchive, or@Capy unarchiveto explicitly reopen it - To keep the archived thread closed, start a new
@Capymention outside the old Slack thread
Capy confirms with: Thread archived - Capy has stopped and this session is closed.
When explicitly reopened, Capy confirms with: Thread unarchived - Capy will respond to messages here again.
Stop
Stop the current run without archiving the thread.
- Type
stop,!stop, or@Capy stopin the thread - Capy stops the current run and keeps the thread active
- Send another message in the thread when you want Capy to start again
Capy confirms with Capy stopped the current run. If no run is active, it replies with Capy is not currently running.
Unlink from Slack
Type unlink, !unlink, or @Capy unlink as the whole reply to pause Slack sync for the current thread. The Capy thread keeps running on web, and Slack receives a pause notice with an Open in Capy link. Resume sync from the thread's Slack control on web.
Start a separate web thread
Add !web anywhere in a message to start a separate thread on web without linking it to Slack. In an existing Capy Slack thread, the new thread starts with the source transcript while the original thread and its Slack sync remain unchanged. In an ordinary Slack conversation, mention @Capy; Capy reads a bounded snapshot as context, then leaves that conversation unlinked. Muted and archived Capy threads also require an explicit @Capy mention.
Capy posts a Started on web card with an Open in Capy link. Continue the new thread on web: later Slack replies never enter it, and its replies, status, pull-request cards, and completion stay off Slack. You can link it to a new Slack thread later from its web menu, but it does not reattach to the source conversation.
Channel mappings
Map specific Slack channels to Capy projects so threads started from those channels are automatically assigned to the right project.
Channel mappings in Slack settings saves each channel's project.
Channels without a mapping fall back to the default project. DMs also use the default project.
Capy also offers to set defaults for you. When neither the channel nor the workspace has a default and Capy has to ask you to pick a project, an admin's pick is followed by a one-time offer: make that project the default everywhere, only for this channel, or don't ask again. Every choice is reversible on the Slack settings page.
Message directives
Configure a thread with key=value directives anywhere in your @Capy message. Directives are stripped from the prompt before the agent sees it, and quoted values are supported.
| Directive | Values | Description |
|---|---|---|
project | project name or ID | Start the thread in a specific Capy project |
folder | folder name | File the new thread into a dashboard folder |
channel | #channel / name | Start the Capy thread in another Slack channel |
title | any text | Set the thread title |
model | model ID or shortcut | Run the thread on a specific model |
reasoning | off, minimal, low through max | Set the model's reasoning effort |
machine | small, medium, large, ultra, hyper | Set the machine size for a new thread or fork |
@Capy project="Payments platform" fix the deploy script
@Capy model=opus reasoning=high investigate the production incident
@Capy channel=at-capy title="Bug report triage" investigate this
@Capy machine=hyper !fast run the full test suite
@Capy !web investigate this on webTo talk to a Captain from Slack, use captain=<name>; see steer a Captain from Slack.
project, folder, title, and machine apply when Capy creates a thread, including channel=, !new, and !web starts. A machine= directive on a normal continuation is refused because an existing thread's machine cannot be resized. Project names match case-insensitively with a safe fuzzy match; when the match is uncertain, Capy asks you to pick instead of guessing.
model= accepts a full catalog ID (openai/gpt-5.6-sol), a model name without its route prefix (gpt-5.6-terra), or a shortcut phrase: fable, opus, sonnet, haiku, sol, terra, luna, gemini, grok, kimi, qwen, glm. A phrase served by more than one connected route (Capy-billed vs a subscription) asks you to pick a route once for the org; a phrase that matches nothing gets an error reply, never a silent guess. A reasoning effort or serving mode can ride on the phrase as trailing words: model=luna-xhigh-fast means the same as model=luna !xhigh !fast.
Use whitespace-delimited bang flags for thread, model, and delivery controls:
| Flag | Effect |
|---|---|
!new | Fork into a separate Slack thread in the current conversation |
!web | Start a separate web thread without Slack sync |
!fast | Enable Fast mode and clear Pro mode |
!pro | Enable Pro mode, clear Fast mode, and clear inherited reasoning |
!standard | Clear Fast and Pro while preserving the model and reasoning |
!off, !minimal, !low, !medium, !high, !xhigh, !max | Set reasoning effort |
!queue | Queue the prompt behind the active run |
!steer | Steer the active run without interrupting it |
Capy refuses conflicting mode flags and an explicit Pro-plus-reasoning combination. A mode-only reply in an existing thread updates later replies and confirms the new selection once.
!new and !web also work in an existing active Capy thread without a mention. !new creates a new Slack thread, while !web creates a web-origin thread with the source conversation as context. !web cannot be combined with !new or channel=.
Repository and branch instructions are ordinary task context, not directives. Write them naturally - "use the backend repository on the staging branch" - and the agent handles them inside the selected project.
Personal connection
Team members can link their Slack identity to their Capy account from Settings → Integrations → Slack. Linking attributes your Slack messages to your Capy user - threads you start from Slack belong to you on the dashboard, and replies carry your name into the agent's context. Unlinked teammates can still talk to Capy in threads; their messages just aren't tied to a Capy account.
Pull request cards
When a Slack-started thread opens or takes over a pull request, Capy posts a card for it into the Slack thread and keeps it current from GitHub state - status, checks, branches, and diff totals update in place, so the card never goes stale as work continues.
- One card per pull request per thread. A thread working across five PRs gets five cards, each updating independently.
- Cards carry Open in Capy and View on GitHub actions.
- Merging or closing a PR posts one compact follow-up sentence, so you're notified even after the card has scrolled away. Everything else - checks progressing, drafts flipping ready, reopens - only updates the card.
- A muted thread gets no new cards, but its existing cards keep updating: muting silences conversation, not a status object you can already see.
Pull request links inside Capy's messages open the Capy pull request view by default. Slack settings can change the destination to GitHub. Each thread keeps the preference it started with, so old messages keep their original destinations.
What agents can do with Slack
When a thread is started from Slack, agents have access to these capabilities:
- Read messages from public channels and private channels where the Capy bot is a member
- Send messages to channels or threads, with optional file attachments
- React to messages with emoji
- List channels to find the right conversation
Agents always respond in the Slack thread that started the Capy thread. They can also send messages to other channels when needed.
Permissions
Capy asks Slack for these bot permissions when your organization connects a workspace. With them, Capy reads only channels it is a member of and direct messages people send it.
| Permission | What Capy uses it for |
|---|---|
app_mentions:read | Start a Capy thread when someone mentions @Capy |
assistant:write | Show that Capy is working in the thread while the agent runs |
channels:history | Follow replies in Capy threads, and read a thread or channel a person asks Capy to use as context, in public channels Capy is a member of |
channels:join | Join a public channel when a person starts Capy there or asks it to post there; Capy never joins channels in bulk or on install |
channels:read | List public channels for channel mappings and find a channel by name |
chat:write | Post replies, progress, and pull request cards, and update cards in place |
chat:write.customize | Show which Captain or Capy user a message comes from |
chat:write.public | Post results to a public channel a person names, without inviting Capy first |
commands | Run the Ask with Capy message shortcut, which starts a thread from any message |
emoji:read | React with your workspace's custom emoji |
files:read | Use images and files attached to a request as context |
files:write | Upload screenshots, logs, and reports the agent produces to the thread |
groups:history | Same as channels:history, in private channels Capy was invited to |
groups:read | Same as channels:read, for private channels Capy is a member of |
im:history | Read direct messages people send to Capy |
im:read | Recognize direct message conversations with Capy |
im:write | Open a direct message to send a person something only they should see |
links:read | Notice Capy thread and pull request links shared in Slack |
links:write | Unfurl those links into previews |
mpim:read | Requested at install because Slack's member_joined_channel event lists it; Capy does not read group direct message contents with it |
reactions:read | Start an automation when someone adds a chosen reaction to a message |
reactions:write | Acknowledge a request with a reaction, and react when asked |
team:read | Show your workspace's name and icon in Capy settings |
users:read | Show people's names instead of user IDs in thread context |
users:read.email | Match a Slack user to their Capy account by email, so threads they start belong to them |
Turning on Slack canvases in Slack settings asks for two more bot permissions. Capy works without them.
| Permission | What Capy uses it for |
|---|---|
canvases:read | Read a canvas a person points Capy at |
canvases:write | Create a canvas or edit one when asked, for example to write a report or checklist |
Read Slack as you is a personal setting on the same page. When a person turns it on, Slack asks them for these read-only user permissions, so Capy can read a conversation the Capy app isn't in after that person approves it. Capy never posts as them.
| Permission | What Capy uses it for |
|---|---|
channels:read, groups:read, im:read, mpim:read | Find the public channel, private channel, direct message, or group direct message the person asked about |
channels:history, groups:history, im:history, mpim:history | Read that conversation as the person |
Data and privacy
The Privacy Policy describes how Capy handles Slack data, and Subprocessors lists the service providers that process it. To remove Capy's access, choose Disconnect in the workspace menu in Slack settings, or remove the app from your Slack workspace.
Troubleshooting
Capy doesn't respond to mentions
/invite @Capy to add it. Also verify the Slack workspace is connected in Settings → Integrations → Slack.Threads go to the wrong project
Capy ignores messages in a thread
unmute or @Capy unmute in the thread to re-enable normal replies. Direct @Capy mentions still work while a thread is muted.Capy didn't react to an `aside` message
aside are excluded from Capy's processing and do not appear in the thread context the agent reads later.Agent can't read a private channel
/invite @Capy in that channel.