Plannotator: zo controleer en annoteer je het plan van je coding-agent voordat hij code schrijft

Plannotator opent het plan van je coding-agent in je browser, zodat je het kunt markeren en feedback kunt geven voordat er code wordt geschreven. Hier lees je de installatie, de commando’s en de kleine lettertjes over privacy.

Graphic of a browser window with a marked-up plan and comment bubbles, illustrating the Plannotator tool for reviewing coding agent plans.

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:

Terminal
curl -fsSL https://plannotator.ai/install.sh | bash

In Windows PowerShell:

Code
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:

Code
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:

Code
/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:

  1. De agent rondt zijn plan af en vraagt om de planmodus te verlaten (de README noemt deze stap ExitPlanMode).
  2. Er gaat een hook af en een lokale server opent het plan in je browser.
  3. Je maakt je aantekeningen en keurt het plan daarna goed of af.
  4. 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:

Code
/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 je PATH mogelijk 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/config is LocalForward 19432 localhost:19432. In een container, of voor een andere poort, stel je PLANNOTATOR_REMOTE=1 en PLANNOTATOR_PORT=9999 in 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.0 zonder 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=none opent 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=0 in om de klassieke werkwijze terug te krijgen.
  • De plugin wil niet updaten. Voer claude plugin marketplace update plannotator uit, daarna claude plugin update plannotator@plannotator, en start dan opnieuw.
  • Je wilt er vanaf. Doe eerst een proefrun met plannotator uninstall --dry-run en voer daarna plannotator uninstall uit. 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.

Geschreven door Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Over Mindloop Experience

Reacties

Schrijf een reactie

Meer van Mindloop Experience

Alles van Mindloop Experience bekijken

Je kunt tot 50 keer klappen.