plannotator

Annotate AI coding agent plans with structured feedback in a browser UI.

40|9|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/akillness/oh-my-skills --skill plannotator-akillness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plannotator
Source: https://github.com/akillness/oh-my-skills/tree/main/.agent-skills/plannotator
Command: npx skills add https://github.com/akillness/oh-my-skills --skill plannotator-akillness

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) components.

What problem does it solve?

Interactive plan and diff review for AI coding agents. Visual browser UI for annotating agent plans — approve or request changes with structured feedback. Supports code review, image annotation, and auto-save to Obsidian/Bear Notes.

Core Features & Use Cases

  • Visual plan review UI for AI coding agents
  • Annotate with actions (approve, request changes, insert, replace, delete, comment)
  • Code review and diff annotation across Claude Code, Gemini CLI, Codex CLI, and OpenCode
  • Auto-save to Obsidian or Bear Notes

Quick Start

Open plannotator in a planning session, annotate the plan, and approve or request changes to proceed.

Frequently Asked Questions about plannotator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I visually review and annotate AI coding agent plans before execution?

Visual plan review for AI coding agents lets you open a browser UI to annotate plans, approve actions, or request changes with structured feedback before coding begins. It works across Claude Code, Gemini CLI, Codex CLI, and OpenCode workflows.

Can I capture and annotate code diffs from Claude Code or Gemini CLI?

Yes, diff annotation for Claude Code and Gemini CLI automatically captures code changes and presents them in a visual browser UI. You can insert, replace, delete, or comment on specific diff sections to provide structured feedback.

Do I need Python 3 installed to use the plannotator workflow?

Python 3 is required for optional tooling that handles safe configuration and JSON merging within the plannotator workflow. You also need the locally installed plannotator CLI and a browser UI for annotation.

How do I save annotated code review diffs to Obsidian or Bear Notes?

Auto-saving annotated diffs to Obsidian or Bear Notes is a built-in feature of the visual plan review workflow. Once you finish annotating code changes in the browser UI, the results can be automatically exported to your local notes application.

What's the best way to provide structured feedback on an AI agent's proposed coding plan?

Using a visual annotation UI allows you to apply structured actions like approve, request changes, insert, replace, delete, or comment directly onto an AI agent's proposed plan. This ensures clear, actionable feedback before the agent executes any code.

Does plannotator work with OpenCode and Codex CLI for plan validation?

Yes, plan validation through visual review is supported across OpenCode and Codex CLI workflows, alongside Claude Code and Gemini CLI. It enables interactive diff annotation and structured plan approval across these AI coding agent environments.