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

​
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. 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.
Last modified on August 9, 2026