Show HN: Plannotator – annotate agent plans, diffs, and HTML

Show HN: Plannotator – annotate agent plans, diffs, and HTML(github.com)

5 points by ramoz 24 days ago | 2 comments

I started this in January as a hook for Claude Code's plan mode: when it finished planning, instead of approving a wall of text in the terminal, the plan opens in your browser and you could mark it up like a document. Your annotations go back into the agent session.

It grew from there. There's now PR-style code review (git, jj, p4, GitHub/GitLab PRs) and annotation for markdown, URLs, and folders. Agents produce a lot of HTML now, so Plannotator renders those artifacts and lets you annotate them too. Nine harnesses are supported: Claude Code, Codex, Copilot CLI, Gemini, OpenCode, Kiro, Droid, Amp, and Pi. Over 100 contributors.

Nothing leaves your machine unless you share... which is E2E encrypted: eg. the plan is encrypted in the browser, the server stores ciphertext, and the key lives in the URL fragment.

As agents get better, the bottleneck shifts to review before and after agents work (obvious to us all now).

Open source, MIT or Apache-2.

quinncom 15 days ago |

I just got it working with Pi, it works great.

I use Pi inside nono.sh sandbox, which requires setting:

export PLANNOTATOR_REMOTE=1

Then adding to the nono profile:

{ "filesystem": { "allow": [ "~/.plannotator" ], }, “network": { “open_port": [0], "listen_port": [19432] }, "open_urls": { "allow_localhost": true } }

NicoJuicy 22 days ago |

I didn't saw your post, but plannotator is really nice!

I've been using it since someone of Cloudflare on x mentioned it. Nice work man!