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

# Using Augment Code Review

> A native GitHub experience to catch critical issues, comment on pull requests, and collaborate on fixes.

## Quickstart

<Tabs>
  <Tab title="New Users">
    <Steps>
      <Step title="Create an Augment Account">
        Visit [augmentcode.com](https://www.augmentcode.com) and click **Sign Up**. Complete registration with your email address, verify your email, and accept the terms of service during onboarding.
      </Step>

      <Step title="Connect GitHub to Configure your Repos for Code Review">
        Log in to [app.augmentcode.com](https://app.augmentcode.com), navigate to **Settings** → **Code Review** → **Configuration**, and click **Connect GitHub**. You'll be redirected to GitHub to authorize the app. Select the repositories you want to grant access to (all repositories or specific repos) and click **Install & Authorize**.
      </Step>

      <Step title="Choose Your Review Style">
        While on [Configuration](https://app.augmentcode.com/settings/code-review), select your preferred review style. **Thorough** (default) provides comprehensive coverage, catching 50% more bugs, while **Precise** focuses on the most critical issues with fewer comments. Learn more about [Review Styles](/codereview/review-style).
      </Step>

      <Step title="Set Review Trigger for Repositories">
        Navigate to **Settings** → **Code Review** → [Configuration](https://app.augmentcode.com/settings/code-review). Under **Repositories**, set the **Review Trigger** for each repository: **Automatic** (review triggers when a PR comes out of draft), **Manual Command** (review triggers by commenting `auggie review`), or **Disabled** (no reviews).
      </Step>

      <Step title="Submit Your First Review">
        Create a pull request on GitHub in any enabled repository. For automatic reviews, mark the PR as "ready for review" and Augment will analyze it within minutes. For manual reviews, add a comment with `auggie review` to trigger the analysis.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Enterprise Plan" icon="building">
    <Steps>
      <Step title="Contact Your Enterprise Administrator">
        Before using Code Review, your Enterprise Plan administrator must enable the feature for your organization. Request access to specific repositories or organization-wide access, and confirm any custom enterprise policies or guidelines. Provide your GitHub organization name and list of repositories you want to enable.
      </Step>

      <Step title="Install the Augment GitHub App">
        If not already installed, navigate to [app.augmentcode.com/settings/code-review](https://app.augmentcode.com/settings/code-review) and click **Connect GitHub**. Select your organization (requires organization admin permissions), choose repository access level, and click **Install & Authorize**. See [Setup Guide for Enterprise](/codereview/setup-guide-enterprise) for detailed instructions.
      </Step>

      <Step title="Choose Your Review Style">
        Navigate to **Settings** → **Code Review** → [Configuration](https://app.augmentcode.com/settings/code-review), select your preferred review style. **Thorough** (default) provides comprehensive coverage, catching 50% more bugs, while **Precise** focuses on the most critical issues with fewer comments. Review style will apply to all Repositories. Learn more about [Review Styles](/codereview/review-style).
      </Step>

      <Step title="Set Review Trigger for Repositories">
        **For Admins:** Navigate to **Settings** → **Code Review** → [Configuration](https://app.augmentcode.com/settings/code-review). Under **Repositories**, set the **Review Trigger** for each repository: **Automatic** (review triggers when a PR comes out of draft), **Manual Command** (review triggers by commenting `auggie review`), or **Disabled** (no reviews). **For Non-Admins:** Contact your administrator to request access to additional repositories.
      </Step>

      <Step title="Start Using Code Review">
        Create a pull request in an enabled repository. For automatic reviews, mark the PR as "ready for review". For manual reviews, comment `auggie review`. Code Review will analyze and post review comments. Address feedback and use the **Fix with Augment** button to resolve issues in your IDE.
      </Step>
    </Steps>

    <Card title="Setup Guide for Enterprise Plan" icon="gear" href="/codereview/setup-guide-enterprise">
      Enterprise Plan administrators can configure Augment Code Review and grant repository access on GitHub.
    </Card>
  </Tab>

  <Tab title="All Other Plans" icon="star">
    Follow these steps if you are on an Indie, Standard, or Max plan.

    <Steps>
      <Step title="Connect GitHub to Configure your Repos for Code Review">
        Visit [app.augmentcode.com/settings/code-review](https://app.augmentcode.com/settings/code-review) and log in. Click **Connect GitHub to Get Started** to install the Augment GitHub App. You'll be redirected to GitHub to authorize the app and select repositories. Choose **All repositories** for organization-wide access or **Only select repositories** for specific repos, then click **Install & Authorize**.
      </Step>

      <Step title="Set Review Trigger for Repositories">
        As an Administrator, navigate to **Settings** → **Code Review** → [Configuration](https://app.augmentcode.com/settings/code-review). Under **Repositories**, set the **Review Trigger** for each repository: **Automatic** (review triggers when a PR comes out of draft), **Manual Command** (review triggers by commenting `auggie review`), or **Disabled** (no reviews).
      </Step>

      <Step title="Choose Your Review Style">
        While on [Configuration](https://app.augmentcode.com/settings/code-review), select your preferred review style. **Thorough** (default) provides comprehensive coverage, catching 50% more bugs, while **Precise** focuses on the most critical issues with fewer comments. Learn more about [Review Styles](/codereview/review-style).
      </Step>

      <Step title="Start Reviewing Pull Requests">
        Create or open a pull request in GitHub. For automatic reviews, mark the PR as "ready for review". For manual reviews, comment `auggie review`, `augment review`, or `augmentcode review`. Code Review will add 👀 to show it's reviewing and post comments on any issues found.
      </Step>
    </Steps>

    <Card title="Setup Guide for All Other Plans" icon="star" href="/codereview/setup-guide-otherplans">
      Learn more about setting up Augment Code Review for Indie, Standard, and Max plans.
    </Card>
  </Tab>
</Tabs>

***

## Context powered code reviews focus on high-impact issues

Augment Code Review prioritizes high signal-to-noise ratio by focusing on high-impact issues:

* **Bugs**: Logic errors, edge cases, and potential runtime issues
* **Security concerns**: Vulnerabilities, unsafe operations, and data exposure risks
* **Correctness**: Null handling and error management
* **Cross-system problems**: Breaking changes, API compatibility, and integration issues

The agent avoids low-value style nags and focuses on objective issues by gathering context from multiple sources:

* **PR Contents**: The agent analyzes the complete code diff to understand what changed and why.

* **Entire Repository**: Through Augment's Context Engine, the agent has access to your full codebase, enabling it to identify cross-system impacts and maintain consistency with existing patterns.

* **PR Title and Description**: More detailed PR descriptions help the agent provide better, more targeted reviews. Include information about:
  * What the PR accomplishes
  * Why the changes were made
  * Any special considerations or context

***

## Best Practices

**Write detailed PR descriptions**: The more context you provide in your PR title and description, the better the agent can understand your intent and provide relevant feedback.

**Use custom guidelines**: Define repository-specific review guidelines to help the agent focus on your team's priorities and domain-specific concerns.

**Provide feedback**: Give feedback on comments using the thumbs up emoji to indicate whether the comment is useful or thumbs down if the comment was not helpful.

**Ask for a follow-up review**: If you make significant changes to the PR and want another review, then ask for a follow-up review by commenting on your PR with the same comments as a manual request: `auggie review`, `augment review`, or `augmentcode review`. The agent will add 👀 to the comment so you know it is reviewing the PR.