SOP-018: Slack Integration

Document Control

• Version: 1.0
• Last Updated: 2024
• Category: Integrations

---

Purpose

Connect Cursor with Slack to use Cloud Agents directly from Slack by mentioning @cursor.

---

Scope

This SOP covers:

• Installing the Cursor Slack app
• Using Cloud Agents from Slack
• Configuring defaults and settings
• Managing agents in threads

---

Prerequisites

• Slack workspace with admin access
• Cursor account with Cloud Agents enabled
• GitHub connected to Cursor
• Usage-based pricing enabled

---

Procedure

Step 1: Install Slack App

1. Go to Cursor Integrations
2. Click Connect next to Slack
3. Follow Slack's installation flow
4. Return to Cursor to complete setup:
   • Connect GitHub (if not already)
   • Pick a default repository
   • Enable usage-based pricing
   • Confirm privacy settings

Step 2: Basic Usage

Mention @cursor with your prompt:

@Cursor fix the login bug

Commands:

Command	Description
@Cursor [prompt]	Start a Cloud Agent
@Cursor settings	Configure defaults
@Cursor list my agents	Show running agents
@Cursor help	Show command list

Step 3: Use Advanced Options

Customize agent behavior with options:

@Cursor [branch=dev, model=o3, repo=owner/repo] Fix the bug

Available Options:

Option	Description	Example
branch	Base branch	branch=main
model	AI model	model=o3
repo	Target repository	repo=owner/repo
autopr	Auto-create PR	autopr=false

Step 4: Work in Threads

Cloud Agents use thread context:

• Follow-up: Reply to agent message with @Cursor [instructions]
• New agent in thread: Use @Cursor agent [prompt]
• Context menu: Click ⋯ for options

Context Menu Options:

• Add follow-up
• Delete agent
• View request ID
• Give feedback

Step 5: Configure Channel Defaults

Set defaults per channel:

1. Run @Cursor settings in the channel
2. Set default repository
3. All team members use these defaults

Priority order:

1. Explicit options in message
2. Channel settings
3. Personal defaults

Step 6: Configure Privacy

Manage privacy from Cloud Agents Dashboard:

Setting	Description
Display Agent Summary	Show summaries in Slack (may contain code)
External Channels	Show summaries in Slack Connect channels

---

Permissions Required

Permission	Purpose
app_mentions:read	Detect @mentions
channels:history	Read thread context
chat:write	Send status updates
files:read/write	Handle attachments
reactions:write	Mark status (⏳ ✅ ❌)

---

Verification Checklist

• [ ] Slack app installed
• [ ] GitHub connected
• [ ] Default repository set
• [ ] @Cursor help returns command list
• [ ] Test agent runs successfully

---

Troubleshooting

Issue	Solution
Bot not responding	Check bot is in channel
Wrong repository	Set channel default with @Cursor settings
Agent failed	Use cursor review verbose=true for details
Permission denied	Verify GitHub app has repo access

---

See Also

• SOP-017: GitHub Integration
• SOP-021: Cloud Agents