backnotprop/plannotator

Was macht plannotator?

Code- und Änderungspläne von KI-Agenten visuell annotieren und prüfen, mit dem Team teilen und mit einem Klick Feedback an Agenten senden.

Funktionsweise

Plannotator integriert sich nahtlos in den Arbeitsablauf von KI-Code-Agenten. Nachdem ein Agent einen Plan oder einen Code-Diff erstellt hat, kann der Entwickler diesen direkt im Tool öffnen.

• Visuelle Diff-Anzeige: Änderungen werden zeilenweise mit Hervorhebung dargestellt (grün für Hinzufügungen, rot für Löschungen).
• Inline-Annotationen: Füge Kommentare direkt zu bestimmten Zeilen oder Abschnitten hinzu.
• Freigabe: Teile geprüfte Diffs oder Pläne über einen Link mit deinem Team.
• Ein-Klick-Feedback: Sende Korrekturanfragen oder Ablehnungen direkt zurück an den Agenten, der den Plan erstellt hat.

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex CLI
• GitHub Copilot (eingeschränkt)

Verwendung

# Plannotator aufrufen (Beispiel mit Claude Code)
plannotator review --plan plan.md --diff changes.diff

# Mit Team teilen
plannotator share --review-id abc123

# Feedback senden
plannotator feedback --review-id abc123 --status approve

Konfiguration

Variable	Beschreibung	Standard
PLANNOTATOR_API_KEY	API-Schlüssel für den Zugriff	-
PLANNOTATOR_TEAM	Team-Name für gemeinsame Überprüfungen	default

Hinweis: Die Freigabe- und Feedback-Funktionen erfordern einen gültigen API-Schlüssel.

Beispiel

Angenommen, ein Agent schlägt eine Änderung in einer Datei vor:

- function oldName() { return 1; }
+ function newName() { return 1; }

Mit Plannotator kannst du die Änderung annotieren:

„Bitte nenne die Funktion calculateValue statt newName.”

Dann sendest du mit einem Klick Feedback an den Agenten, der die Anpassung vornimmt.

Lizenz

MIT