@coderabbit in a channel, or open the CodeRabbit app to start a direct conversation.
Prerequisites
Before you start, make sure you have:- Permission to install or reauthorize apps in the Slack workspace
- Access to the Git organization, workspace, or account whose repositories CodeRabbit Agent should use
- Permission to install or configure CodeRabbit for those repositories
- A CodeRabbit organization admin who can configure Agent; billing-only admins cannot manage connections or scopes
Setup steps
1
Select your CodeRabbit organization
Sign in to CodeRabbit, select the organization whose repositories Agent should use, and open Slack. The setup flow uses that organizationâs Git platform: GitHub, GitLab (cloud or self-managed), Bitbucket Cloud, or Azure DevOps.
2
Connect Slack
Choose Connect Slack to install the app and grant the required Slack permissions. When Slack is connected, choose Continue setup, or Start Agent trial if itâs offered. An existing installation resumes at its next incomplete setup step.
3
Complete provider setup
For GitHub, Bitbucket Cloud, and Azure DevOps, follow the setup prompts to authenticate with the provider, select the organization, workspace, or account, and make the approved repositories available to Agent.For GitLab, repositories are displayed without per-repository checkboxes. In organizations that do not use SSO, Agent uses repositories installed for CodeRabbit that the selected token can access. SSO workspaces use the token-visible group catalog. For a self-managed instance, follow Self-managed GitLab setup.
4
Add connections
On Add workspace context, add the connections the agent should use, such as your issue tracker or documentation tools. Add this to the Base Scope is selected by default, so a new connection is available wherever the Base Scope applies. If you clear it, the agent can use the connection only after you select it in a named scope under Scopes. Choose Continue to finish setup on Slack â Channel mappings.
5
Start using CodeRabbit Agent
Once setup is complete, open CodeRabbit from Slackâs Apps sidebar or search for âCodeRabbitâ in Slack â the Chat tab shows starter prompts to help you begin. You can also mention
@coderabbit in any channel to start a conversation there. In the web app, you can refine scopes and channel mappings, connections, and sandbox settings at any time.What the Base Scope does
The Base Scope is your organizationâs default scope. In Slack, itâs the Slack default: it applies to every conversation and member that no assignment matches. Runs under the Base Scope can use every repository available to CodeRabbit Agent through your Git provider, and the connections selected in the Base Scope. CodeRabbit Agent cannot run in Slack without it. To narrow access for specific channels or people, create a scope with only the repositories and connections they need, and assign it in Slack â Channel mappings. See Connections and scopes for the full model.Resuming setup
The setup flow is resumable. If provider access is still propagating or a required step is incomplete, the Agent returns the workspace to the next missing requirement instead of forcing admins to start over.Fixing an incorrect GitHub connection
If the wrong GitHub account or organization was connected, a global admin can reset the workspace GitHub connection from account settings and restart setup with the correct identity.Whatâs next
Working in Slack
Learn how mentions and direct conversations work day to day.
Connections
Add external systems like Jira, Notion, or Sentry for CodeRabbit Agent to use.
Scopes
Add scopes to tailor repositories, connections, and spend limits for specific channels or teams.