Work with Background Agents from Slack
Command | Description |
---|---|
@Cursor [prompt] | Start a Background Agent. In threads with existing agents, adds followup instructions |
@Cursor settings | Configure defaults and channel’s default repository |
@Cursor [options] [prompt] | Use advanced options: branch , model , repo |
@Cursor agent [prompt] | Force create a new agent in a thread |
@Cursor list my agents | Show your running agents |
Option | Description | Example |
---|---|---|
branch | Specify base branch | branch=main |
model | Choose AI model | model=o3 |
repo | Target specific repository | repo=owner/repo |
autopr | Enable/disable automatic PR creation | autopr=false |
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.
https://github.com/org/repository
org/repository
main
)
Permission | Description |
---|---|
app_mentions:read | Detects @mentions to start Background Agents and respond to requests |
channels:history | Reads previous messages in threads for context when adding follow-up instructions |
channels:join | Automatically joins public channels when invited or requested |
channels:read | Accesses channel metadata (IDs and names) to post replies and updates |
chat:write | Sends status updates, completion notifications, and PR links when agents finish |
files:read | Downloads shared files (logs, screenshots, code samples) for additional context |
files:write | Uploads visual summaries of agent changes for quick review |
groups:history | Reads previous messages in private channels for context in multi-turn conversations |
groups:read | Accesses private channel metadata to post responses and maintain conversation flow |
im:history | Accesses direct message history for context in continued conversations |
im:read | Reads DM metadata to identify participants and maintain proper threading |
im:write | Initiates direct messages for private notifications or individual communication |
mpim:history | Accesses group DM history for multi-participant conversations |
mpim:read | Reads group DM metadata to address participants and ensure proper delivery |
reactions:read | Observes emoji reactions for user feedback and status signals |
reactions:write | Adds emoji reactions to mark status - ⏳ for running, ✅ for completed, ❌ for failed |
team:read | Identifies workspace details to separate installations and apply settings |
users:read | Matches Slack users with Cursor accounts for permissions and secure access |