Slack

The Slack integration lets your team run Nimbus tasks and get updates directly in Slack.

Create a Slack App

1. Go to api.slack.com/apps and click Create New App → From scratch
2. Name it Nimbus and select your workspace

Slash commands

Under Slash Commands, create:

Command	Request URL	Description
/nimbus	https://api.get-nimbus.com/slack/command	Run Nimbus commands

Event subscriptions

Under Event Subscriptions, enable events and set the Request URL to https://api.get-nimbus.com/slack/events.

Subscribe to bot events:

• app_mention
• message.channels

OAuth scopes

Under OAuth & Permissions, add these bot token scopes:

• commands
• chat:write
• channels:read
• channels:history

Install and configure

1. Click Install to Workspace and authorize
2. Copy the Bot User OAuth Token (xoxb-...)
3. Copy the Signing Secret from Basic Information
4. Add both to your Nimbus backend .env:

SLACK_BOT_TOKEN=xoxb-...
SLACK_SIGNING_SECRET=...
SLACK_CLIENT_ID=...
SLACK_CLIENT_SECRET=...

Commands

/nimbus run

/nimbus run add rate limiting to the /api/users endpoint

Nimbus posts a thread in the channel with live progress updates. When complete, it posts the PR URL.

/nimbus review

/nimbus review https://github.com/acme/api/pull/142

Runs a review of the PR and posts the structured critique in the thread.

/nimbus status

/nimbus status

Shows the status of any currently running tasks.

Progress updates

Nimbus posts thread replies as a task progresses through phases:

nimbus-bot  ·  Running: add rate limiting to /api/users
─────────────────────────────────────────────────────
  ✓ indexing   847 files ready
  ✓ planning   4 changes planned
  ⋯ implementing...

When complete:

  ✓ verified    pytest 47/47
  ✓ done        https://github.com/acme/api/pull/143

Channel-to-repo mapping

To run tasks against a specific repo from a channel, Nimbus matches the channel's connected workspace to a repo. Configure the default repo for each Slack workspace in the dashboard under Integrations → Slack.