Research: plannotator-annotate

Cached research evidence for plannotator-annotate (not authority).

Back to catalog page

Plannotator-annotate launches the external Plannotator browser UI to annotate a markdown file, converted HTML, URL, or folder. The skill runs plannotator annotate <path-or-url>, waits for the annotation session, and feeds returned structured annotations back into the conversation for follow-up work. It is designed for cases where visual plan or document review benefits from a dedicated surface rather than inline chat.

Target agents: antigravity, claude-code, codex, crush, cursor, gemini-cli, github-copilot, grok, opencode. The skill sets disable-model-invocation: true and delegates entirely to the plannotator CLI plus browser UI; the agent does not perform the annotation itself.

Curated status install-now-after-trust-gate; trust_tier curated-trust-gated. The wrapper is minimal and shells out to a separately installed plannotator binary (MIT, open source at backnotprop/plannotator). Primary risks are execution of the external CLI, browser-launched local UI that can read local paths or URLs provided by the user, and optional encrypted sharing features. The project is actively developed with public demos and integrations for multiple agents; local execution keeps plans on-machine by default. Audit the installed binary and any companion hooks (e.g. grok-plannotator-hooks.json) before broad deployment.

  1. Install the Plannotator CLI: curl -fsSL https://plannotator.ai/install.sh \| bash (or uv run wagents grok plannotator install).
  2. npx skills add backnotprop/plannotator/apps/skills/core --skill plannotator-annotate -y -g -a antigravity claude-code codex crush cursor gemini-cli github-copilot grok opencode

Works alongside the review and last skills; Grok integration uses repo-synced hooks.

backnotprop (https://github.com/backnotprop/plannotator). Official site: https://plannotator.ai/

Inline plan/code review inside the primary agent chat; GitHub awesome-copilot excalidraw-diagram-generator or other visual diagramming skills for architecture sketches; dedicated PR review tools for code changes.

> Evidence gathered from public GitHub sources, raw SKILL.md, and project site (plannotator.ai). Not an endorsement or authority; inspect the CLI binary, hooks, and network behavior before use.