Agent skill · backnotprop
plannotator
Reference for using the Plannotator CLI: plan review, code review, annotating files, URLs, folders, and running local apps, annotating the last assistant message, browsing archived plan decisions, and exporting or sharing Guided Reviews. Invoke when asked to use Plannotator for anything not covered by a more specific plannotator-* skill.
What it needs
About 9k tokens when loaded.
What this skill does
Plannotator CLI Reference Plannotator is a local, browser-based review layer for agent workflows: it opens plans, diffs, and documents in an annotation UI, the human marks them up, and the structured feedback comes back to you on stdout. It installs as a single plannotator binary plus per-host hooks, so plan review fires automatically when you exit plan mode; every other surface is launched explicitly from the CLI. A session runs on a random localhost port (fixed port 19432 in remote mode) and blocks until the reviewer submits feedback, approves, or closes the tab. This skill is the knowledge layer. The plannotator-review, plannotator-annotate, and plannotator-last skills are thin launchers for the three most common actions; use this reference when you need to pick the right command or flags yourself. Choose the command The user wants Run --- --- Review a plan you produced Nothing. Plan review opens automatically on plan exit via hooks. Never run bare plannotator yourself. Review and explicitly approve a plan/spec saved as a file plannotator annotate <file> --gate --json Review current code changes plannotator review Review a GitHub PR or GitLab MR plannotator review <PRURL> Annotate a markdown, text, config, or HTML file plannotator annotate <file> Annotate a web page plannotator annotate <https-url> Annotate a running local app (dev server) plannotator annotate <http://localhost:PORT/> Pick a file to annotate from a folder plannotator annotate <folder/> Annotate your latest assistant message plannotator last Browse past plan decisions plannotator archive Export or share a Guided Review plannotator guide export / plannotator guide share Reopen or list live sessions plannotator sessions Session model Every review or annotate command starts a local web server, opens the browser, and blocks until the human decides. That can take minutes. Launch it with a long (or no) command timeout, or in the background, then read stdout when the process exits. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills backnotprop/plannotator--63f757