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

# Archie Reviewer

> Archie Reviewer is an AI reviewer for pull requests. Learn when it runs, what it checks, how it uses your plan credits, and how to require it before a pull request can merge.

**Archie Reviewer** is an AI reviewer for pull requests. It reads the changes, leaves comments, adds suggested code to some of them, and gives a verdict. It **only reviews**. It never merges.

In the conversation of a pull request, it appears as **Archie Reviewer** with an **Agent** label. It works the same way for the Frontend and for Logic services.

> [!WARNING]
>
> Archie Reviewer consumes AI credits. Each review is charged against your plan's credits, like other AI usage in Archie. The cost depends on the size of the pull request. The dialogs that start a review show the minimum cost before you confirm.

## When Archie reviews

Archie reviews a pull request in two cases:

* **On request.** Someone selects **Request review** in **Reviewers** and chooses **Archie Reviewer**, or selects **Request Archie review** on the pull request.
* **When the pull request is created.** The project setting **Code review** controls this.

### The Code review setting

**Code review** is a project-wide setting. Find it in the **Settings** tab of **Manage branches** in the Frontend. In a service, it appears on the **Branches** page. Only Owners and Admins can change it. Everyone else sees the current value.

The setting is called **Archie Reviewer reviews automatically**. It controls whether Archie reviews a pull request when it is opened:

| Option | What happens |
| - | - |
| **Never: only when someone requests it on the PR** | Archie reviews only when asked. |
| **When the PR is opened** | Archie reviews once, when the pull request opens. |

Archie never reviews on its own at any other time. After the first review, it reviews again only when someone asks.

The setting applies to the Frontend and to all services.

The **Archie review** checkbox in the **Open pull request** dialog follows this setting. It starts checked unless the setting is **Never**. You can check or clear it for each pull request.

## Require Archie's review

A protected branch can require Archie's review before a pull request merges. Turn on **Require Archie Reviewer** in the [protection rules](https://archie.com/docs/frontend/branching/protected-branches.md#protection-rules) of the branch. While Archie has not reviewed, or its review is out of date, **Merge status** shows messages such as **Archie hasn't reviewed yet** and the merge is blocked.

## What a review costs and when it is charged

* A review needs enough available credits. Without them, the review is refused with "Couldn't review: not enough credits." and a **Buy credits** button.
* Before you request a review, a dialog explains that the review costs at least a number of credits, depending on the size of the pull request. Confirm with **Confirm and charge**.
* Requesting a review again is charged again.
* If Archie already reviewed the same commit, it does not review it again and **nothing is charged**.
* If Archie runs out of credits before it finishes, the review is partial. The notice reads **Reviewed *x* of *y* files**, and you can request the review again.
* Applying a suggestion is free.

## Opt out for one pull request

Before Archie gives a verdict, select **Don't review with Archie** to leave Archie out of that pull request. This option is not offered when the target branch requires Archie's review.

## What Archie reviews

Archie skips files it cannot review and lists them as **Not reviewed**, with the reason: lockfiles, binary files, files that are too large, and generated files. It also flags sensitive files that changed. If there was nothing Archie could review, the review says so.

A review can end with a notice, for example when Archie could not finish the rest of the files or when it did not post some comments. The notice tells you what was left out.

## Next steps

* [Pull requests](https://archie.com/docs/frontend/branching/pull-requests.md)
* [Protected branches](https://archie.com/docs/frontend/branching/protected-branches.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.