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

The `.toml` files are native Gemini CLI commands, not Agent Skills.

The standard installer also writes Plannotator's shared core skills under `~/.agents/skills` for hosts that read that location. Before you copy or remove either file type, read [Install and Manage Plannotator Skills](/open-source/start/skills#understand-host-specific-files).

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

Rerun the installer to update the native command files, policy, and managed hook entry, then restart Gemini CLI.

Last verified against Plannotator OSS v0.25.1 on July 31, 2026. Maintained by the Plannotator project.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.