CLI-Referenz

Die Planu CLI (planu) ermöglicht es, Planu vom Terminal aus zu verwalten — in KI-Tools installieren, Specs validieren, Audits ausführen und vieles mehr.

Schnellstart

npm install -g @planu/cli
planu <command>

# Oder ohne globale Installation
npx @planu/cli@latest <command>

Befehle

planu install

Erkennt installierte KI-Tools (Claude Code, Cursor, Windsurf, Zed, Cline, Continue) und fügt den Planu-MCP-Eintrag in deren Konfigurationsdateien ein.

planu install [--scope user|project] [--all]

Flag	Beschreibung
--scope user|project	Auf Benutzer- (global) oder Projektebene installieren. Wird abgefragt, wenn weggelassen.
--all	Auswahlmenü überspringen und in allen erkannten Tools installieren.

# interaktive Installation
planu install

# in allen erkannten Tools auf Benutzerebene ohne Interaktion installieren
planu install --scope user --all

planu doctor

Prüft alle bekannten Konfigurationspfade jedes KI-Tools und meldet, ob der Planu-MCP-Eintrag vorhanden, fehlend oder fehlerhaft ist.

planu doctor

Beispielausgabe:

Planu Doctor

  [+] Claude Code (user)    OK  ~/.claude.json
  [-] Cursor                not installed
  [?] Zed                   tool not found

Planu is installed in 1 location(s). Run `planu install` to add more.

planu uninstall

Findet alle Konfigurationsdateien, die einen Planu-MCP-Eintrag enthalten, und entfernt diesen nach Bestätigung.

planu uninstall [--yes]

Flag	Beschreibung
--yes / -y	Bestätigungsabfrage überspringen (nützlich in Skripten).

planu status

Aktualisiert den Status einer Spec (z. B. von draft zu approved).

planu status <specId> --set <status> [--project-id ID] [--notes "..."]

Flag	Beschreibung
--set / -s	Neuer Status: draft, review, approved, implementing, done, blocked.
--notes / -n	Optionale Reviewnotizen, die mit dem Übergang verknüpft werden.
--project-id	Projekt-ID. Wird automatisch aus dem aktuellen Verzeichnis erkannt, wenn weggelassen.

planu status SPEC-042 --set approved
planu status SPEC-042 --set done --notes "Alle Kriterien verifiziert"

planu validate

Validiert eine Spec gegen ihren Quellcode — prüft, welche Akzeptanzkriterien abgedeckt sind, und meldet die Gesamtabdeckung.

planu validate <specId> [--project-id ID]

planu validate SPEC-042
planu validate SPEC-042 --project-id 1ef29aa7362bb087

planu audit

Führt ein Code-Qualitäts-Audit am Projekt durch und bewertet es von 0 bis 100 nach SOLID-Prinzipien, Clean Code und Architekturkonformität.

planu audit [--path .] [--project-id ID] [--spec SPEC-001]

Flag	Beschreibung
--path / -p	Zu prüfendes Verzeichnis. Standard: aktuelles Verzeichnis.
--spec / -s	Audit auf eine bestimmte Spec beschränken.
--project-id	Projekt-ID. Wird automatisch erkannt, wenn weggelassen.

planu estimate

Schätzt den Implementierungsaufwand einer Spec — Stunden, Komplexität und Kostenaufschlüsselung.

planu estimate <specId> [--project-id ID]

planu estimate SPEC-042

planu create

Erstellt eine neue Spec mit Titel und optionalen Metadaten.

planu create <title> [--type feature] [--description "..."] [--path .]

Flag	Beschreibung
--type / -t	Spec-Typ: feature, fix, chore, spike.
--description / -d	Kurze Beschreibung. Verwendet den Titel, wenn weggelassen.
--path / -p	Projektverzeichnis. Standard: aktuelles Verzeichnis.
--scope	Geltungsbereich der Spec.
--target	Zielebene oder -modul.
--feature	Übergeordnete Funktionsgruppe.

planu create "OAuth-Login hinzufügen" --type feature
planu create "Null-Pointer beim Checkout beheben" --type fix --description "Null-Pointer wenn der Warenkorb leer ist"

planu list

Listet alle Specs im aktuellen Projekt auf, optional gefiltert nach Status oder Typ.

planu list [--status draft] [--type feature] [--project-id ID]

Flag	Beschreibung
--status / -s	Nach Status filtern: draft, review, approved, implementing, done, blocked.
--type / -t	Nach Typ filtern: feature, fix, chore, spike.
--project-id	Projekt-ID. Wird automatisch erkannt, wenn weggelassen.

planu list
planu list --status approved
planu list --type fix --status done

planu init

Initialisiert ein Verzeichnis als Planu-Projekt — scannt den Technologie-Stack, konfiguriert die Sprache und erstellt die Projektmetadaten.

planu init [path] [--locale en] [--rate 100] [--level junior|mid|senior] [--profile developer]

Flag	Beschreibung
--locale / -l	Sprache für Spec-Inhalte: en, es, pt, fr, de, zh.
--rate / -r	Stundensatz in USD für Kostenschätzungen.
--level	Erfahrungsstufe: junior, mid, senior.
--profile	Benutzerprofil: developer, product-owner, designer, non-technical.

planu init
planu init /pfad/zum/projekt --locale de --rate 90

planu serve

Startet den Planu-MCP-Server mit HTTP-Transport statt stdio. Nützlich für Remote- oder browserbasierte Clients.

planu serve [--port 3100]

planu serve --port 8080

planu dashboard

Öffnet das Planu-Web-Dashboard — eine lokale Browser-Oberfläche zum Durchsuchen von Specs, Metriken und Berichten.

planu dashboard [--port 5050]

planu dashboard
planu dashboard --port 9000

planu watch

Überwacht ein Projektverzeichnis auf Dateiänderungen und löst konfigurierte Hook-Handler aus (on-save, on-create, on-delete).

planu watch [path] [--hooks on-save,on-create] [--verbose] [--dry-run]

Flag	Beschreibung
--hooks / -H	Kommagetrennte Hook-Typen. Standard: on-save,on-create,on-delete.
--verbose / -V	Detaillierte Hook-Ausführungsprotokolle anzeigen.
--dry-run	Vorschau der auszulösenden Hooks, ohne sie auszuführen.

planu watch
planu watch /pfad/zum/projekt --hooks on-save --verbose
planu watch --dry-run

planu handoff

Erstellt einen strukturierten Handoff-Prompt, damit ein KI-Agent eine Spec autonom implementieren kann.

planu handoff <specId> [--name Agent-1] [--role implementer] [--files src/a.ts,src/b.ts]

Flag	Beschreibung
--name / -n	Agentenname. Standard: Agent-1.
--role / -r	Agentenrolle: implementer, reviewer, tester. Standard: implementer.
--files / -f	Kommagetrennte Liste der diesem Agenten zugewiesenen Dateien.
--project-id	Projekt-ID. Wird automatisch erkannt, wenn weggelassen.

planu handoff SPEC-042
planu handoff SPEC-042 --name "Backend-Agent" --role implementer --files src/api/auth.ts,src/middleware/jwt.ts

Typische Arbeitsabläufe

In allen erkannten Hosts installieren

planu install --global

Headless-Modus für CI/CD

Verwende dieselben uneingeschränkten lokalen Befehle in CI; es ist keine kommerzielle Planu-Berechtigung erforderlich.

planu validate SPEC-042
planu audit --path /pfad/zum/projekt

Vollständiger SDD-Zyklus vom Terminal aus

planu init                                     # Projekt initialisieren
planu create "Zahlungsfluss hinzufügen" --type feature
planu list --status draft                      # ausstehende Specs prüfen
planu status SPEC-001 --set approved
planu validate SPEC-001                        # Abdeckung nach Implementierung prüfen
planu audit                                    # Code-Qualität bewerten

Globale Flags

Diese Flags gelten für alle Befehle.

Flag	Kurz	Beschreibung
--help	-h	Hilfe für den aktuellen Befehl anzeigen.
--version		Installierte Planu-Version anzeigen.
--json		Rohausgabe als JSON (nützlich für Scripting und Pipes).
--quiet	-q	Nicht wesentliche Ausgaben unterdrücken.
--verbose		Vollständige Stack Traces bei Fehlern anzeigen.