Skip to main content
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. 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

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.
Last modified on July 19, 2026