> ## 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 the current branch and consolidate the results into a final verdict.

Run a multi-agent review against the current branch.

```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
```

## 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 local`        | With `--configure`, deliver the verdict locally. 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`                | Browse local review findings.                                                                                                                                                       |
| `--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`        | Maximum time each reviewer may run before being marked failed. Defaults to `10m0s`; `0` disables the 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`. |
| `--list`                    | List configured review profiles, reviewers, judges, and output modes.                                                                                                               |
| `-h, --help`                | Show help for `entire review`.                                                                                                                                                      |

<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/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
```