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

# review

> Run a multi-agent review against a branch and consolidate the results into a final verdict.

Run a multi-agent review against the current branch, or against another branch with `--target`.

```bash theme={null}
entire review [PROFILE] [flags]
```

`entire review` starts reviewer agents in parallel, then uses a judge agent to consolidate their reports into a final verdict.

Reviews are saved as named profiles in Entire settings. On first run, guided setup writes a profile and asks before starting agents.

## Configure a Review Profile

Open the review setup flow:

```bash theme={null}
entire review --configure
```

Use non-interactive flags when you want to create or update a profile from a script:

```bash theme={null}
entire review --configure \
  --set-agents codex,claude-code \
  --set-judge codex \
  --set-output local
```

This creates the default `general` profile unless you choose another profile name in the interactive setup.

## Run a Review

Run a named profile:

```bash theme={null}
entire review general
```

You can also select a profile with `--profile`:

```bash theme={null}
entire review --profile general
```

Scope the review against a specific base branch:

```bash theme={null}
entire review general --base origin/main
```

Add one-off instructions for a single run:

```bash theme={null}
entire review general --prompt "Focus on auth, error handling, and missing tests."
```

Run only one reviewer from the selected profile:

```bash theme={null}
entire review general --agent codex
```

Review a branch other than the one you are on, without switching your checkout. Entire checks it out in a worktree and reviews it there:

```bash theme={null}
entire review general --target feature/token-refresh --cleanup-worktree
```

## Flags

| Flag | Description |
| - | - |
| `--configure` | Set up a review profile. Shows available agents and profiles unless paired with `--set-*` flags. |
| `--set-agents AGENTS` | With `--configure`, set comma-separated reviewer agents for the profile. |
| `--set-judge AGENT[=MODEL]` | With `--configure`, set the consolidating judge. |
| `--set-output MODE` | With `--configure`, set where the verdict is delivered: `local` or `trail`. Defaults to `local`. |
| `--local` | With `--configure`, save to `.entire/settings.local.json` instead of shared `.entire/settings.json`. |
| `--set-task TEXT` | With `--configure`, set the profile's canonical task text. |
| `--set-model AGENT=MODEL` | With `--configure`, set a model for a reviewer agent. Repeatable. |
| `--set-slot AGENT[=MODEL]` | With `--configure`, set one reviewer slot. Repeatable; the same agent or model can appear more than once. |
| `--edit` | Reopen the advanced review profile skill picker. |
| `--findings [HANDLE]` | Browse local review findings. Pass a handle to print one saved run. |
| `--agent NAME` | Run one reviewer from the selected profile. |
| `--agents` | List reviewer agents available for the selected profile. |
| `--model NAME` | Override the model for the selected `--agent` reviewer. Requires `--agent`. |
| `--models` | List the models each review agent advertises. Optionally combine with `--agent NAME`. |
| `--profile NAME` | Select a review profile. You can also pass the profile name as the positional argument. |
| `--prompt TEXT` | Add one-off instructions for this review run. |
| `--timeout DURATION` | Time limit for each reviewer and the judge. By default, reviewers have no timeout and the judge has a 20-minute timeout. |
| `--base REF` | Scope the review against a Git ref instead of the default mainline ref. Defaults to the first existing ref from `origin/HEAD`, `origin/main`, `origin/master`, `main`, or `master`. |
| `--target REF` | Check out a branch in a worktree and run the review there. Accepts a branch name, a trail ID, or an Entire trail URL. |
| `--cleanup-worktree` | Remove a newly created `--target` worktree after a successful review. Interactive runs ask when you omit this flag. |
| `--list` | List configured review profiles with their reviewers and judge. |
| `-h, --help` | Show help for `entire review`. |

A reviewer that exceeds the timeout is canceled and marked failed; the other reviewers and the judge continue. If the judge times out or fails, the review ends without a verdict.

<Note>
  `entire review --findings` only browses local findings. It does not apply fixes.
</Note>

## Attach an Existing Review

To tag an already-finished session as a review, use [`entire session attach`](/cli-reference/session#session-attach) with `--review`:

```bash theme={null}
entire session attach SESSION_ID --review
```

## Examples

```bash theme={null}
# Configure a review profile
entire review --configure

# Configure a profile without the interactive setup
entire review --configure --set-agents codex,claude-code --set-judge codex --set-output local

# Run the general profile
entire review general

# Review a stacked branch against its parent
entire review general --base origin/my-parent-branch

# Run one configured reviewer
entire review general --agent codex

# Browse local findings
entire review --findings

# List configured profiles
entire review --list
```

## Continue with

<CardGroup cols={2}>
  <Card title="Review and Recap Agent Work" icon="graduation-cap" href="/learn/review-and-recap-agent-work">
    Configure reviewers, run a review, and inspect recent activity in one tutorial.
  </Card>

  <Card title="Review Profiles" icon="sliders" href="/guides/configuration/review-profiles">
    Configure shared and local review behavior.
  </Card>
</CardGroup>