Plannotator: So prüfst und kommentierst du den Plan deines Coding-Agents, bevor er Code schreibt

Plannotator öffnet den Plan deines Coding-Agents im Browser, damit du ihn markieren und Feedback geben kannst, bevor Code entsteht. Hier findest du Installation, Befehle und das Kleingedruckte zum Datenschutz.

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

Dein Coding-Agent hat gerade einen Zwölf-Schritte-Plan vorgeschlagen und will ein Daumen hoch, bevor er dein Projekt umschreibt. Du überfliegst ihn im Terminal, tippst „looks good“ (sieht gut aus) und hoffst, dass Schritt neun nichts löscht, was dir gefällt.

Plannotator ist ein Open-Source-Tool, das dieses Überfliegen durch eine richtige Review-Sitzung ersetzt: Der Plan öffnet sich in deinem Browser, du kommentierst ihn Zeile für Zeile, und deine Notizen gehen direkt zurück an den Agent. So richtest du es ein und nutzt es, bevor auch nur eine Zeile Code geschrieben wird.

Was du brauchst

  • Einen unterstützten Coding-Agent. Das README nennt Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp und Pi.
  • Ein Terminal und einen Browser. Plannotator ist laut README „a local, browser-based review surface“ (eine lokale, browserbasierte Review-Oberfläche).
  • Git, das der Installer laut der Installationsdokumentation von Plannotator für Skills braucht.

Plannotator ist kostenlos, steht unter einer Doppellizenz (Apache 2.0 oder MIT), und sein GitHub-Repo (backnotprop/plannotator) zeigt mit Stand 15. November 2026 rund 11.400 Sterne. Es wurde am 28. Dezember 2025 angelegt, und die neueste Version, v0.28.65, erschien am selben Tag. Die Befehle unten stammen aus dem README und der Doku mit Stand 15. November 2026 und wurden mit diesen Seiten abgeglichen; die Shell-Zeilen bestehen eine Syntaxprüfung, installiert haben wir Plannotator für diesen Artikel aber nicht.

Schritt 1: Programm installieren

Unter macOS, Linux oder WSL:

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

Unter Windows PowerShell:

Code
irm https://plannotator.ai/install.ps1 | iex

Laut Doku fügt der Installer den Befehl plannotator hinzu, prüft den Download anhand seiner SHA-256-Prüfsumme und installiert Hooks und Basis-Skills für die Agents, die er findet. Beim ersten Start fragt er, ob zusätzliche Skills installiert werden sollen; die Standardantwort ist Nein. Prüfe, ob alles geklappt hat:

Code
plannotator --version

Wenn es dir nicht geheuer ist, ein Skript direkt in deine Shell zu pipen, bietet die Doku eine reine Binary-Installation (--minimal) und eine Möglichkeit, eine Version festzulegen und ihre Herkunft zu verifizieren.

Schritt 2: Agent verbinden

Claude Code braucht einen Extraschritt. Führe in Claude Code Folgendes aus:

Code
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

Starte Claude Code danach neu. Laut README brauchen Codex und Gemini CLI nichts weiter (Gemini setzt Version 0.36.0 oder neuer voraus), OpenCode braucht "plugin": ["@plannotator/opencode@latest"] in opencode.json, und Pi nutzt pi install npm:@plannotator/pi-extension. Wenn Hooks und Skills neu für dich sind, erklärt unser Guide zu Agent Skills in Claude Code, wie alles zusammenspielt.

Schritt 3: Agent einen Plan schreiben lassen

Dafür tippst du keinen Befehl. Laut README ist der Plan-Modus über die Hooks des jeweiligen Agents angebunden: Sobald dein Agent das nächste Mal einen Plan fertig hat, öffnet sich die Review-Ansicht von selbst.

Hinter den Kulissen läuft es laut README so ab:

  1. Der Agent beendet seinen Plan und möchte den Plan-Modus verlassen (das README nennt diesen Schritt ExitPlanMode).
  2. Ein Hook wird ausgelöst, und ein lokaler Server öffnet den Plan in deinem Browser.
  3. Du kommentierst und gibst den Plan dann frei oder lehnst ihn ab.
  4. Lehnst du ab, geht strukturiertes Feedback an den Agent zurück, der den Plan überarbeitet. Ein Plan-Diff zeigt, was sich geändert hat.

Laut der Website von Plannotator kannst du Abschnitte kommentieren, Text zum Löschen markieren oder Ersatztext schreiben und dann mit diesem Feedback freigeben oder ablehnen.

Erwartetes Ergebnis: ein Browser-Tab mit deinem Plan, bereit zum Kommentieren.

Schritt 4: Vorhandenes kommentieren

Plannotator ist nicht auf Pläne beschränkt. Diese Befehle stammen aus dem README:

Code
/plannotator-last
/plannotator-annotate README.md
/plannotator-annotate src/
/plannotator-review

Der erste kommentiert die letzte Nachricht deines Agents. Mit dem zweiten und dritten markierst du eine Datei oder einen Ordner. Der letzte öffnet einen Diff-Viewer im Pull-Request-Stil für deine noch nicht committeten Änderungen; stattdessen kannst du auch die URL eines GitHub-PRs oder eines GitLab-Merge-Requests übergeben. In Codex ersetzt du die Schrägstriche durch die Skills $plannotator-*.

Was mit deinen Daten passiert

Laut README „does not collect usage telemetry or analytics“ (erfasst Plannotator weder Nutzungstelemetrie noch Analysedaten), und Pläne, Diffs und Kommentare bleiben standardmäßig lokal. Es nennt aber auch Ausnahmen, die du kennen solltest:

  • Jede Review-Ansicht fragt beim Laden bei GitHub nach der neuesten Version. Laut README lässt sich diese Prüfung derzeit nicht abschalten.
  • „Ask AI“ schickt die Frage und den relevanten Kontext an deinen eingestellten Anbieter.
  • Beim Teilen eines Plans entsteht ein Link. Laut README werden kleine Freigaben unverschlüsselt direkt in den Link gepackt, sodass jeder mit dem Link sie lesen kann. Große Freigaben werden vor dem Hochladen verschlüsselt, und gehostete Pastes laufen nach 7 Tagen ab.

Häufige Fehler und Lösungen

  • plannotator: command not found. Öffne ein neues Terminal. Laut Doku hat sich dein PATH möglicherweise geändert.
  • Die Review-Seite lädt nicht über SSH oder im Container. Über SSH wechselt Plannotator laut README auf den festen Port 19432, und die passende Zeile für ~/.ssh/config lautet LocalForward 19432 localhost:19432. Im Container oder für einen anderen Port setzt du PLANNOTATOR_REMOTE=1 und PLANNOTATOR_PORT=9999 und leitest stattdessen diesen Port weiter. Neu bei SSH? Schau in unseren Guide zu SSH-Schlüsseln.
  • Der Remote-Modus ist sperrangelweit offen. Das README warnt: Im Remote-Modus lauscht der Server auf 0.0.0.0 ohne Login, also kann ihn jeder nutzen, der den Port erreicht. Halte den Port für Netzwerke, denen du nicht vertraust, geschlossen.
  • Es erscheint gar kein Fenster. PLANNOTATOR_BROWSER=none öffnet keinen Browser, und die Sitzungs-URL wird immer ausgegeben.
  • Claude wartet nicht mehr auf dich. Ab Claude Code 2.1.287 beendet Claude laut README seinen Zug, und deine Entscheidung kommt später als Nachricht an. Setze PLANNOTATOR_CLAUDE_MOD=0, um den klassischen Ablauf zurückzuholen.
  • Das Plugin aktualisiert sich nicht. Führe claude plugin marketplace update plannotator aus, dann claude plugin update plannotator@plannotator, und starte anschließend neu.
  • Du willst es loswerden. Mach mit plannotator uninstall --dry-run einen Probelauf und führe dann plannotator uninstall aus. Standardmäßig bleiben deine Pläne und dein Verlauf erhalten.

Das Fazit

Ein Plan, den du wirklich liest, kommt dich billiger als ein Diff, den du hinterher mühsam auseinandernehmen musst. Wenn du deinen Agent auch einen Browser steuern lässt, wirf einen Blick auf unser Setup für Chrome DevTools MCP.

Quellen

Links zuletzt geprüft am 15. November 2026.

Von 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.

Über Mindloop Experience

Kommentare

Kommentar schreiben

Mehr von Mindloop Experience

Alle Artikel von Mindloop Experience

Du kannst bis zu 50-mal applaudieren.