Je coding-agent heeft net een plan van twaalf stappen voorgesteld en wil een duim omhoog voordat hij je project gaat herschrijven. Je scant het in de terminal, typt ‘looks good’ (ziet er goed uit) en hoopt maar dat stap negen niets verwijdert waar je aan gehecht bent.
Plannotator is een opensource-tool die dat vluchtige scannen vervangt door een echte reviewsessie: het plan opent in je browser, je becommentarieert het regel voor regel en je notities gaan direct terug naar de agent. Zo stel je het in en gebruik je het voordat er ook maar één regel code wordt geschreven.
Wat je nodig hebt
- Een ondersteunde coding-agent. De README noemt Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp en Pi.
- Een terminal en een browser. Plannotator is volgens de README ‘a local, browser-based review surface’ (een lokale reviewomgeving in je browser).
- Git, dat de installer volgens de installatiedocumentatie van Plannotator nodig heeft voor skills.
Plannotator is gratis, heeft een dubbele licentie (Apache 2.0 of MIT) en op 15 november 2026 telt de GitHub-repo (backnotprop/plannotator) zo’n 11.400 sterren. De repo is aangemaakt op 28 december 2025 en de nieuwste release, v0.28.65, verscheen diezelfde dag. De commando’s hieronder komen uit de README en documentatie zoals die op 15 november 2026 waren en zijn met die pagina’s vergeleken; de shellregels doorstaan een syntaxcontrole, maar we hebben Plannotator voor dit artikel niet geïnstalleerd.
Stap 1: installeer het programma
Op macOS, Linux of WSL:
curl -fsSL https://plannotator.ai/install.sh | bash
In Windows PowerShell:
irm https://plannotator.ai/install.ps1 | iex
Volgens de documentatie voegt de installer het commando plannotator toe, controleert hij de download met de SHA-256-checksum en installeert hij hooks en basisskills voor de agents die hij vindt. Bij de eerste keer vraagt hij of je extra skills wilt toevoegen; het standaardantwoord is nee. Controleer of het gelukt is:
plannotator --version
Vind je het spannend om een script rechtstreeks naar je shell te pipen? De documentatie biedt ook een installatie van alleen de binary (--minimal) en een manier om een versie vast te zetten en de herkomst ervan te verifiëren.
Stap 2: koppel je agent
Claude Code heeft één extra stap nodig. Voer in Claude Code het volgende uit:
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator
Start Claude Code daarna opnieuw. Volgens de README hebben Codex en Gemini CLI verder niets nodig (Gemini vereist versie 0.36.0 of nieuwer), heeft OpenCode "plugin": ["@plannotator/opencode@latest"] nodig in opencode.json, en gebruikt Pi pi install npm:@plannotator/pi-extension. Zijn hooks en skills nieuw voor je? Onze gids over agent skills in Claude Code legt uit hoe alles in elkaar grijpt.
Stap 3: laat je agent een plan schrijven
Hiervoor hoef je geen commando te typen. Volgens de README is de planmodus via de hooks van elke agent gekoppeld, dus de volgende keer dat je agent een plan afrondt, opent het reviewscherm vanzelf.
Achter de schermen gaat het volgens de README zo:
- De agent rondt zijn plan af en vraagt om de planmodus te verlaten (de README noemt deze stap
ExitPlanMode). - Er gaat een hook af en een lokale server opent het plan in je browser.
- Je maakt je aantekeningen en keurt het plan daarna goed of af.
- Keur je het af, dan krijgt de agent gestructureerde feedback en past hij het plan aan. Een plan-diff laat zien wat er veranderd is.
Volgens de website van Plannotator kun je opmerkingen bij secties plaatsen, tekst markeren om te verwijderen of vervangende tekst schrijven, en daarna met die feedback erbij goedkeuren of afkeuren.
Verwacht resultaat: een browsertabblad met je plan, klaar om te annoteren.
Stap 4: annoteer wat je al hebt
Plannotator werkt niet alleen voor plannen. Deze commando’s komen uit de README:
/plannotator-last
/plannotator-annotate README.md
/plannotator-annotate src/
/plannotator-review
Het eerste annoteert het laatste bericht van je agent. Met het tweede en derde markeer je een bestand of map. Het laatste opent een diff-viewer in pull-request-stijl voor je nog niet gecommitte wijzigingen; je kunt in plaats daarvan ook de URL van een GitHub-PR of GitLab-merge request meegeven. Vervang in Codex de slashes door de skills $plannotator-*.
Wat het met je data doet
Volgens de README ‘does not collect usage telemetry or analytics’ (verzamelt Plannotator geen gebruikstelemetrie of analytics) en blijven plannen, diffs en annotaties standaard lokaal. Er staan ook uitzonderingen in die je moet kennen:
- Elk reviewscherm controleert bij het laden op GitHub wat de nieuwste release is. Volgens de README kun je die controle momenteel niet uitzetten.
- ‘Ask AI’ stuurt de vraag en de relevante context naar de provider die je hebt ingesteld.
- Als je een plan deelt, krijg je een link. Volgens de README worden kleine shares onversleuteld in de link zelf gestopt, dus iedereen met de link kan ze lezen. Grote shares worden versleuteld voordat ze worden geüpload, en gehoste pastes verlopen na 7 dagen.
Veelvoorkomende fouten en oplossingen
plannotator: command not found. Open een nieuwe terminal. Volgens de documentatie is jePATHmogelijk veranderd.- De reviewpagina laadt niet via SSH of in een container. Via SSH schakelt Plannotator volgens de README over op vaste poort 19432, en de regel voor je
~/.ssh/configisLocalForward 19432 localhost:19432. In een container, of voor een andere poort, stel jePLANNOTATOR_REMOTE=1enPLANNOTATOR_PORT=9999in en forward je die poort. Nieuw met SSH? Bekijk onze gids over SSH-sleutels. - Remote-modus staat wagenwijd open. De README waarschuwt dat de server in remote-modus luistert op
0.0.0.0zonder login, dus iedereen die de poort kan bereiken, kan hem gebruiken. Houd de poort dicht voor netwerken die je niet vertrouwt. - Er verschijnt helemaal geen venster.
PLANNOTATOR_BROWSER=noneopent geen browser, en de sessie-URL wordt altijd getoond. - Claude wacht niet meer op je. Vanaf Claude Code 2.1.287 beëindigt Claude volgens de README zijn beurt en komt je beslissing later binnen als bericht. Stel
PLANNOTATOR_CLAUDE_MOD=0in om de klassieke werkwijze terug te krijgen. - De plugin wil niet updaten. Voer
claude plugin marketplace update plannotatoruit, daarnaclaude plugin update plannotator@plannotator, en start dan opnieuw. - Je wilt er vanaf. Doe eerst een proefrun met
plannotator uninstall --dry-runen voer daarnaplannotator uninstalluit. Standaard blijven je plannen en geschiedenis bewaard.
Conclusie
Een plan dat je echt leest, is goedkoper dan een diff die je achteraf moet ontrafelen. Laat je je agent ook een browser besturen? Bekijk dan onze setup voor Chrome DevTools MCP.
Bronnen
Links voor het laatst gecontroleerd op 15 november 2026.





Schrijf een reactie