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

# Tusk Review Overview

> Automatically review pull requests for bugs and quality issues

Tusk Review is an AI code reviewer that runs on PRs to find bugs and code quality issues. The `@use-tusk` bot will leave inline comments for any issues and include a fix prompt, so you can resolve issues quickly before merge.

## How It Works

<Steps>
  <Step title="Create or update a PR">
    Tusk Review runs when a PR is created or when new commits are pushed. Trigger Tusk Review at any time by commenting `@use-tusk review` in the PR.
  </Step>

  <Step title="Tusk scans for bugs and issues">
    AI evaluates changed files for bugs, security issues, performance/reliability problems, and maintainability concerns. When Tusk finds an issue, **@use-tusk** posts an inline PR comment with the risk and suggested fix.

    <img className="block" src="https://mintcdn.com/tusk/5a67vGvhNTPNlszJ/images/tusk-review-comment-example.png?fit=max&auto=format&n=5a67vGvhNTPNlszJ&q=85&s=ac27a11f35bfe69ac5179f0bd2dc3135" alt="Tusk code review example PR comment" width="1974" height="1548" data-path="images/tusk-review-comment-example.png" />
  </Step>

  <Step title="Use AI prompt to investigate">
    Each finding includes an AI prompt you can copy and paste into your coding agent to investigate and fix the issue.

    <img className="block h-96" src="https://mintcdn.com/tusk/5a67vGvhNTPNlszJ/images/tusk-review-ai-prompts.png?fit=max&auto=format&n=5a67vGvhNTPNlszJ&q=85&s=1e13f93c44b84322e971ce207eea648f" alt="Tusk AI prompts in example PR comment" width="1528" height="1212" data-path="images/tusk-review-ai-prompts.png" />
  </Step>

  <Step title="Apply fixes and push changes">
    Update your code based on the review comments, then push commits to the same PR branch.
  </Step>

  <Step title="Tusk re-reviews automatically">
    Tusk re-runs on the latest commit and updates feedback, helping you verify that previous findings are resolved before merge.
  </Step>
</Steps>

## Trigger a review on demand

Beyond the automatic run on PR creation and new commits, you can request a review any time by commenting on a PR:

```
@use-tusk review
```

The PR author must have an active Tusk seat for the review to run.

## Setup

<Info>
  This guide assumes you have already [connected your
  repo](/onboarding#connect-version-control-platform). Tusk Review is
  stack-agnostic and does not require a test execution environment.
</Info>

<Steps>
  <Step title="Choose a repo">
    In the [Repos page](https://app.usetusk.ai/app/repos), click **Code Review** for the repository you want to configure.

    <img className="block" src="https://mintcdn.com/tusk/5a67vGvhNTPNlszJ/images/tusk-repos-page-with-code-review.png?fit=max&auto=format&n=5a67vGvhNTPNlszJ&q=85&s=e43311bededf5b2426100aed3bb1f1be" alt="Tusk Repos page with Code Review in repo card" width="3450" height="1164" data-path="images/tusk-repos-page-with-code-review.png" />
  </Step>

  <Step title="Enable code review">
    Enable the toggle to turn on Tusk Review for all PR authors with an active Tusk seat. Toggle other repo-level settings as needed.

    <img className="block" src="https://mintcdn.com/tusk/5a67vGvhNTPNlszJ/images/tusk-code-review-config-page.png?fit=max&auto=format&n=5a67vGvhNTPNlszJ&q=85&s=4676c5170202511e8df1556629bd5e9f" alt="Tusk code review configuration page" width="3452" height="1146" data-path="images/tusk-code-review-config-page.png" />
  </Step>

  <Step title="Optional: Configure individual preferences">
    To change individual preferences for how Tusk Review runs, go to [Settings > GitHub/GitLab Seats](https://app.usetusk.ai/app/settings/seats), click **Edit preferences**, and select the relevant checkboxes under Code Review Configuration.

    <img className="block" src="https://mintcdn.com/tusk/5a67vGvhNTPNlszJ/images/tusk-code-review-seat-config-page.png?fit=max&auto=format&n=5a67vGvhNTPNlszJ&q=85&s=e11a1b9b46cfdf7217fe775b61482c3d" alt="Tusk code review seat-level configuration panel" width="1720" height="1884" data-path="images/tusk-code-review-seat-config-page.png" />
  </Step>
</Steps>