## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://docs.entire.io/llms.txt)

Use this file to discover all available pages before exploring further.

Run a multi-agent review against the current branch.

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

```
entire review --configure
```

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

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

```
entire review general
```

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

```
entire review --profile general
```

Scope the review against a specific base branch:

```
entire review general --base origin/main
```

Add one-off instructions for a single run:

```
entire review general --prompt "Focus on auth, error handling, and missing tests."
```

Run only one reviewer from the selected profile:

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

`entire review --findings` only browses local findings. It does not apply fixes.

## Attach an Existing Review

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

```
entire session attach SESSION_ID --review
```

## Examples

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