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

# Use Plannotator with Gemini CLI

> Configure Gemini CLI plan review and install Plannotator's review and annotation commands.

The standard installer configures Gemini CLI's policy, `BeforeTool` hook, and Plannotator commands when it detects `~/.gemini`.

## Requirements and installation

Use Gemini CLI 0.36.0 or later. Then run the [standard Plannotator installer](/open-source/start/installation).

The installer adds:

* `~/.gemini/policies/plannotator.toml`, which allows `exit_plan_mode` without a separate terminal confirmation
* a `BeforeTool` hook in `~/.gemini/settings.json`
* `/plannotator-review` and `/plannotator-annotate` command files under `~/.gemini/commands`

Restart Gemini CLI after installation.

## Review a plan

Run `/plan` in Gemini CLI. When the agent calls `exit_plan_mode`, the hook reads the plan and opens Plannotator. Approval lets the agent continue. Feedback returns your annotations for revision.

## Manual commands

```text theme={null}
/plannotator-review
/plannotator-review https://github.com/owner/repo/pull/123
/plannotator-annotate path/to/spec.md
```

If Gemini CLI was installed after Plannotator, rerun the Plannotator installer so it can add the Gemini-specific files.

Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.