Slack

With Cherri Code's integration for Slack, you can use Cloud Agents to work on your tasks directly from Slack by mentioning @cursor with a prompt.

Get started

Installation

1. Go to Cherri Code integrations

2. Click Connect next to Slack or go to installation page from here

3. You'll be prompted to install the Cherri Code app for Slack in your workspace.

4. After installing in Slack, you'll be redirected back to Cherri Code to finalize setup

   1. Connect a repository provider (if not already connected) and pick a default repository
   2. Enable usage-based pricing
   3. Confirm privacy settings

5. Start using Cloud Agents in Slack by mentioning @cursor

How to use

Mention @cursor and give your prompt. Cherri Code tries to detect a repository, model, base branch, or named cloud agent environment from your message. It also uses your recent agent activity when selecting a repository.

For a named environment, include its name in your prompt. For example: @Cherri Code use the Platform environment to update the shared API.

Commands

Run @Cherri Code help for an up-to-date command list.

Options

Customize Cloud Agent behavior with these options:

Syntax formats

Natural:

@Cherri Code with opus, fix the login bug in backend-api

Inline:

@Cherri Code env=Platform branch=dev model=opus autopr=false Fix the login bug

Use quotes for environment names with spaces:

@Cherri Code env="Platform Services" Update the shared API

Option precedence

When combining options:

• Explicit values override defaults
• Later values override earlier ones if duplicated
• Inline options take precedence over settings modal defaults
• env takes precedence over repo when both are present
• pool, worker, machine, and self_hosted=false (or sh=0) take precedence over the channel default pool and the team default pool

The bot parses options from anywhere in the message, allowing natural command writing.

Cherri Code ignores key=value options inside triple-backtick code blocks, even one-line blocks, and leaves the code in your prompt as written. In this message, pool=None is inside the code block, so it doesn't pick a pool:

@Cherri Code why does this crash? ```engine = create_engine(db_url, pool=None)```

Using thread context

Cloud Agents understand and use context from existing thread discussions. Useful when your team discusses an issue and you want the agent to implement the solution based on that conversation.

When to use force commands

When do I need @Cherri Code agent?

In threads with existing agents, @Cherri Code [prompt] adds follow-up instructions. Who can follow up is controlled by Team follow-ups. If Team follow-ups is Disabled, only the owner can follow up. To launch a separate agent, use @Cherri Code agent [prompt], or ask in natural language:

@Cherri Code start a new agent to refactor billing

Phrases like "create a new agent", "launch a fresh agent", or "new agent please" work the same way.

When do I need Add follow-up (from context menu)?

Use the context menu (⋯) on an agent's response for followup instructions. Useful when multiple agents exist in a thread and you need to specify which one to follow up on.

Status updates & handoff

Before Cherri Code starts changing code, it posts a short plan in the thread when you are fixing a bug or when implementation details would help you follow along. Straightforward requests skip that note. While it works, Cherri Code updates a short status under the thread.

When Cloud Agent runs, you first get an option to Open in Cherri Code.

When Cloud Agent completes, you get a notification in Slack and an option to view the created PR in GitHub.

Managing agents

To see all running agents, run @Cherri Code list my agents.

Manage Cloud Agents using the context menu by clicking the three dots (⋯) on any agent message.

Available options:

• Add follow-up: Add instructions to an existing agent
• Switch repository: Relaunch the same request against a different repository or cloud agent environment
• Delete: Stop and archive the Cloud Agent
• View request ID: View unique request ID for troubleshooting (include when contacting support)
• Give feedback: Provide feedback about agent performance

If the agent needs a repository or environment outside the current one, Slack also shows Switch repository on the launch message. Choose the new target and Cherri Code continues from there.

Configuration

Manage default settings and privacy options from Dashboard → Cloud Agents.

Settings

Default Model

Used when no model is specified in your message. See settings for available options.

Repository Selection

Cherri Code automatically selects the right repository based on:

1. Your message content — Repository names or keywords in your prompt
2. Recent agent activity — Repositories you've used recently
3. Routing rules — Custom keyword-to-repo mappings (see below)
4. Default repository — Fallback when no match is found

To use a specific repository, include its name in your message. For example: @Cherri Code in mobile-app, fix the login bug.

Base Branch

Starting branch for Cloud Agent. Leave blank to use the repository's default branch (often main)

Channel Settings

Configure default settings at the channel level using @Cherri Code settings. These settings are per team and override your personal defaults for that channel.

Particularly useful when:

• Different channels work on different repositories
• Teams want consistent settings across all members

To configure channel settings:

1. Run @Cherri Code settings in the desired channel
2. Set the default repository for that channel
3. All team members using Cloud Agents in that channel use these defaults

Routing Rules

Routing rules let you define keywords that automatically map to a target. When your message contains a keyword, Cherri Code routes the agent to the associated repository or cloud agent environment. Environments can bundle multiple repositories, so one keyword can start an agent with every repo it needs already configured.

Setting up routing rules

1. Go to Dashboard → Cloud Agents
2. Find the Routing Rules section
3. Add keyword-to-target mappings, pointing each keyword at a repository or an environment

Example rules

With these rules configured:

• @Cherri Code fix the frontend nav bug → routes to acme/web-app
• @Cherri Code update the mobile onboarding flow → routes to acme/mobile-app
• @Cherri Code add a migration across the platform → starts in the Platform environment, with all its repos ready

How routing works

Cherri Code evaluates your message in this order:

1. Your message content — Repository names or keywords in your prompt
2. Recent agent activity — Repositories you've used recently
3. Routing rules — Custom keyword-to-target mappings (repository or environment)
4. Channel default — The repository set for this channel
5. Default repository — Fallback when no match is found

Team default pool

Team admins can set one Team Pool as the default for @Cherri Code launches. Members then run on that pool without adding pool=<name> or self_hosted=true to every mention. The default applies to the whole team, in every channel without a channel default pool.

Manage the default from Slack. Setting or clearing it requires the same permission as changing Self-Hosted settings in the dashboard. Anyone can view it.

@Cherri Code pool set my-pool@Cherri Code pool@Cherri Code pool unset

@Cherri Code settings also lists the team default pool.

Channel default pool

Team admins can also give a channel its own pool. @Cherri Code mentions in that channel then run on the channel's pool instead of the team default, and other channels keep the team default. Setting or clearing it takes the same permission as the team default.

Run these in the channel you want to change:

@Cherri Code pool set my-pool channel@Cherri Code pool@Cherri Code pool unset channel

@Cherri Code pool shows the channel's pool next to the team default. To pick from a list instead, run @Cherri Code settings, click Set Pool for Channel, and choose one of your team's pools. Choose Use the team default (no channel pool) to clear it. Once cleared, mentions in the channel go back to the team default.

How Cherri Code picks where a mention runs

Options in your message always win. Cherri Code resolves the target in this order:

1. Options in your message. pool=<name> targets that pool. worker= or machine= targets one of your My Machines. self_hosted=false (or sh=0) runs on Cherri Code's managed infrastructure. Each of these skips both default pools. A bare self_hosted=true (or sh=1) fills in the channel default pool, or the team default pool when the channel has none.
2. Your default My Machines worker. If you have a default worker of your own for the repository, it outranks both default pools.
3. Channel default pool. Used when the channel you mention Cherri Code in has a pool of its own.
4. Team default pool. Used when your message has none of the options above and the channel has no pool of its own.

Repositories and default pools

Repository selection works the same way with a channel or team default pool: message content, recent activity, routing rules, channel default, then your default repository and the team's. What happens next depends on how the pool is registered:

• Any repo pool, no repository resolved. Slack starts an agent on the pool without a repository. Source control is up to the worker, as with any any-repo pool. If a default repository does resolve, the agent gets it as context without limiting which workers can claim the run.
• Repo-bound pool, no repository resolved. Slack rejects the mention with an ephemeral reply instead of falling back to managed infrastructure. Add repo= or pool= to the mention, use self_hosted=false to run on managed infrastructure, or check the default with @Cherri Code pool and @Cherri Code settings.
• Repository resolved and the pool serves it. Slack launches with repo= and pool= set, the same as an explicit pool=<name> mention.
• Repository resolved but the pool's workers only serve other repositories. Slack rejects the mention with an ephemeral reply. Pick a repository the pool serves with repo=, or a pool that serves this repository with pool=.

Privacy

Cloud Agents support Privacy Mode.

Read more about Privacy Mode or manage your privacy settings.

Display Agent Summary

Display agent summaries and diff images. May contain file paths or code snippets. Can be turned On/Off.

Display Agent Summary in External Channels

For Slack Connect with other workspaces or channels with external members like Guests, choose to display agent summaries in external channels.

Permissions

Cherri Code requests these Slack permissions for Cloud Agents to work within your workspace:

Disclaimer

Cherri Code can make mistakes. Please double-check code and responses.

Privacy Policy

For information about how Cherri Code collects, uses, and protects your data, see our Privacy Policy.