> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Set up CodeRabbit Agent for Slack with your Git platform, create the Base Scope, and start working.

export const Hint = ({type, children, headline, tip, href, cta}) => {
  const TIPS = {
    learnings: {
      headline: "Learnings",
      tip: "Review preferences CodeRabbit learns from your chat conversations and applies automatically to future reviews.",
      cta: "Learn about Learnings",
      href: "/knowledge-base/learnings",
      content: "Learnings"
    },
    walkthrough: {
      headline: "PR Walkthrough",
      tip: "A structured comment posted by CodeRabbit at the top of every pull request, summarizing changes, sequence diagrams, review effort, and more.",
      cta: "Learn about PR Walkthroughs",
      href: "/pr-reviews/walkthroughs",
      content: "Walkthrough"
    },
    "finishing-touches": {
      headline: "Finishing Touches",
      tip: "Post-review agentic actions (Autofix, writing docstrings or unit tests, and more) you trigger from a PR comment or a checkbox in the Walkthrough.",
      cta: "See all Finishing Touches",
      href: "/finishing-touches",
      content: "Finishing Touches"
    },
    "coding-plan": {
      headline: "Coding Plan",
      tip: "A detailed, codebase-aware implementation plan CodeRabbit generates from an issue or description, ready to hand off to any coding agent.",
      cta: "Learn about Coding Plans",
      href: "/plan",
      content: "Coding Plan"
    },
    "knowledge-base": {
      headline: "Knowledge Base",
      tip: "The collected context sources CodeRabbit draws on during reviews: Learnings, Code Guidelines, issue trackers, connected MCP servers, and cross-repo analysis.",
      cta: "Explore the Knowledge Base",
      href: "/knowledge-base",
      content: "Knowledge Base"
    },
    "path-instructions": {
      headline: "Path Instructions",
      tip: "Custom review rules that only apply to files matching a glob pattern, e.g. 'src/controllers/**'.",
      cta: "Configure path instructions",
      href: "/configuration/path-instructions",
      content: "Path Instructions"
    },
    "change-stack": {
      headline: "Change Stack",
      tip: "An improved code inspection interface that reorganizes a pull request from a flat file list into a structured, layer-by-layer walkthrough with range-specific summaries and diagrams when useful.",
      cta: "Learn about Change Stack",
      href: "/pr-reviews/change-stack",
      content: "Change Stack"
    },
    scope: {
      headline: "Scope",
      tip: "A named set of repositories, connections, and spend limits that controls what CodeRabbit Agent can access in a given Slack conversation.",
      cta: "Learn about Scopes",
      href: "/slack-agent/scopes",
      content: "Scope"
    },
    "coderabbit-agent": {
      headline: "CodeRabbit Agent for Slack",
      tip: "An AI agent built into Slack that investigates issues, generates implementation plans, and opens pull requests right from the Slack threads.",
      cta: "Explore CodeRabbit Agent",
      href: "/slack-agent",
      content: "CodeRabbit Agent"
    },
    "configuration-inheritance": {
      headline: "Configuration Inheritance",
      tip: "A setting that merges configuration values across multiple levels — repository YAML, central YAML, and UI settings — instead of using only the highest-priority source.",
      cta: "Learn about Configuration Inheritance",
      href: "/configuration/configuration-inheritance",
      content: "Configuration Inheritance"
    }
  };
  const defaults = TIPS[type] || ({});
  return <Tooltip headline={headline ?? defaults.headline} tip={tip ?? defaults.tip} cta={cta ?? defaults.cta} href={href ?? defaults.href}>
      {children ?? defaults.content}
    </Tooltip>;
};

The setup flow connects your Slack workspace to a Git provider, makes approved repositories available to CodeRabbit Agent, and creates a <Hint type="scope">Base Scope</Hint> that defines which repositories, connections, and spend controls apply by default. Once the Base Scope is saved, anyone in the workspace can mention `@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

## Setup steps

<Steps>
  <Step title="Sign in with Slack">
    Go to [app.coderabbit.ai/slack](https://app.coderabbit.ai/slack) to begin. Authenticate with Slack to establish the workspace identity.

    * **New workspace**: Click **Add to Slack** to trigger the full app install flow, grant workspace-level [Slack permissions](/slack-agent/slack-permissions), and enter the setup wizard.
    * **Returning to an existing workspace**: Click **Sign in with Slack**. CodeRabbit identifies the workspace and resumes from whichever setup stage was last completed.
  </Step>

  <Step title="Choose your Git platform">
    Choose the Git platform that should back CodeRabbit Agent for the Slack workspace: GitHub, GitLab (cloud or self-hosted), Bitbucket Cloud, or Azure DevOps.
  </Step>

  <Step title="Complete provider setup">
    Follow the setup prompts to authenticate with your Git platform, select the organization, workspace, or account, and make the approved repositories available to Agent.
  </Step>

  <Step title="Create the Base Scope">
    Choose the default repositories, [connections](/slack-agent/connections), and spend baseline that should apply across the workspace. The [Base Scope](/slack-agent/scopes) is required before CodeRabbit Agent can be used.
  </Step>

  <Step title="Start using CodeRabbit Agent">
    Once the Base Scope is saved, 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](https://app.coderabbit.ai), Slack-specific administration now lives under **Slack** settings. You can refine [scopes](/slack-agent/scopes), [connections](/slack-agent/connections), and [sandbox settings](/slack-agent/sandboxes) at any time.
  </Step>
</Steps>

## What the Base Scope does

The Base Scope is required to complete setup. It sets the default repositories, connections, and spend controls that apply across the workspace. Scopes can override or extend these defaults for specific channels or teams. See [Scopes](/slack-agent/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.

<Warning>
  Resetting the workspace GitHub connection is destructive. It removes existing scopes and workspace usage history for that Slack workspace. Treat it as a recovery path, not a normal reconfiguration step.
</Warning>

## What's next

<CardGroup cols={1}>
  <Card title="Working in Slack" href="/slack-agent/use-in-slack" icon="messages-square" horizontal>
    Learn how mentions and direct conversations work day to day.
  </Card>

  <Card title="Connections" href="/slack-agent/connections" icon="plug" horizontal>
    Add external systems like Jira, Notion, or Sentry for CodeRabbit Agent to use.
  </Card>

  <Card title="Scopes" href="/slack-agent/scopes" icon="shield" horizontal>
    Add scopes to tailor repositories, connections, and spend limits for specific channels or teams.
  </Card>
</CardGroup>