> ## Documentation Index
> Fetch the complete documentation index at: https://doc.entelligence.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Review local changes
> Review local Git changes before you push and return prioritized findings to the terminal, CI, or another coding agent.
Run the Code Review engine before you open or update a pull request. `entelligence review` analyzes your local Git diff and prints prioritized findings in the terminal for a developer, CI job, or coding agent.
## Install and sign in
```bash theme={null}
curl -fsSL https://app.entelligence.ai/install.sh | sh
entelligence auth login
entelligence auth status
```
Alternative installation:
```bash theme={null}
uv tool install entelligence-cli
entelligence update
```
The current in-app guide supports macOS and Linux with Python 3.11 or later.
## Review current work
From the repository you want to review:
```bash theme={null}
cd /path/to/repository
entelligence status
entelligence review
```
The command detects the local Git changes and uses the repository context available to your workspace. Pass `--repo-path` when you run it from another directory.
## Review committed work
Compare committed changes against a specific base branch:
```bash theme={null}
entelligence review --committed-only --base-branch develop
```
Use this when the work is already committed or the target branch is not `main`.
## Shape the output
| Option | Use it to |
| ------------------- | ------------------------------------------------- |
| `--priority high` | Surface only higher-priority findings |
| `--priority medium` | Balance coverage and noise |
| `--priority low` | Include lower-priority findings |
| `--mode concise` | Shorten explanations |
| `--mode verbose` | Include more reasoning |
| `--plain` | Remove rich terminal formatting |
| `--prompt-only` | Produce compact context for another coding agent |
| `--debug` | Print request details and write a local debug log |
## Inspect one file
```bash theme={null}
entelligence diff -f src/app.py
```
This shows the Git diff for one file while preserving the selected repository and base-branch controls.
## Use it in an agent or CI workflow
Store `ENTELLIGENCE_API_KEY` in the platform's approved secret manager:
```bash theme={null}
export ENTELLIGENCE_API_KEY="..."
entelligence auth status
entelligence review --plain
```
Never print or commit the key. Review findings and command failures may share conventional process-exit behavior; use supported structured output or documented parsing when a pipeline must distinguish findings from execution errors.
For a coding agent, `--prompt-only` produces a compact review that can become the next repair task. Always inspect the resulting diff and run the relevant tests before accepting agent-written changes.
## Confirm the review used the right diff
Check that:
* `entelligence auth status` reports an authenticated session.
* `entelligence status` identifies the intended repository.
* The review lists the expected changed files.
* `--committed-only` compares against the selected base branch.
* The chosen priority and mode change the output as expected.
* Plain or prompt-only output contains no rich terminal UI.
## Next step
See the [complete CLI reference](/cli/reference) or configure [pull-request review settings](/code-review/settings).