Erste Schritte

Planu ist ein Plugin für dein KI-Tool, das dir hilft, Software-Funktionen zu planen, zu verfolgen und zu überprüfen. Statt dich in jedem Chat zu wiederholen, erstellst du eine Spec (ein kurzer Plan mit einer "fertig"-Checkliste) und deine KI folgt ihr automatisch.

Funktioniert mit jeder Programmiersprache, jedem Framework und den meisten KI-Tools — auch solchen ohne MCP-Unterstützung.

Installieren

npm install -g @planu/cli

Dann konfiguriere alle deine KI-Tools mit einem Befehl:

planu install --global

Das ist alles. Planu scannt deine Maschine, erkennt jedes installierte KI-Tool und konfiguriert jedes automatisch.

$ planu install --global

Suche nach KI-Tools...
  Claude Code   gefunden  → ~/.claude/claude.json aktualisiert
  Cursor        gefunden  → ~/.cursor/mcp.json aktualisiert
  Windsurf      gefunden  → ~/.windsurf/mcp.json aktualisiert
  OpenCode      gefunden  → ~/.config/opencode/config.json aktualisiert
  Codex         gefunden  → AGENTS.md aktualisiert

Starte deine KI-Tools neu. Planu ist bereit.

Kein JSON bearbeiten. Kein MCP-Wissen erforderlich.

npm nicht installiert?

Nutze npx ohne globale Installation:

npx @planu/cli@latest install --global

Kompatible KI-Tools

MCP-kompatible Tools (Plug-and-Play)

Planu verbindet sich als MCP-Server — dem offenen Standard für KI-Plugins:

KI-Tool	Auto-erkannt
Claude Code	✓
Cursor	✓
Windsurf	✓
OpenCode	✓
Zed	✓
Cline (VS Code)	✓
Continue (VS Code)	✓
Claude Desktop	Manuelle Konfiguration
Gemini CLI	Manuelle Konfiguration

Tools ohne MCP (CLI + HTTP)

Für KI-Tools ohne native MCP-Unterstützung funktioniert Planu auf zwei Arten:

Codex / AGENTS.md-Stil — planu install --codex injiziert Planu-CLI-Anweisungen in AGENTS.md. Codex und jeder LLM, der Agent-Instruktionsdateien liest, nutzt Planu automatisch.

HTTP / OpenAI Function Calling — Starte den HTTP-Server und jeder LLM mit HTTP-Tool-Nutzung (GPT-4, Gemini, Kimi, Claude API) kann Planu-Tools direkt aufrufen:

planu serve --http --port 7823
# Tools verfügbar unter: POST http://localhost:7823/v1/tools/call
# Tool-Liste unter:      GET  http://localhost:7823/v1/tools

Berechtigungsabfragen überspringen (empfohlen)

Standardmäßig fragt dein KI-Tool jedes Mal nach Genehmigung, wenn Planu ein Tool verwendet. Um alle Planu-Tools automatisch zu genehmigen (sicher — Planu liest und schreibt nur lokale Spec-Dateien):

Claude Code

claude settings add permissions.allow "mcp__planu__*"

Oder manuell zu ~/.claude/settings.json hinzufügen:

{
  "permissions": {
    "allow": ["mcp__planu__*"]
  }
}

Cursor

In den Cursor-Einstellungen → Features → MCP → Auto-approve für den Planu-Server aktivieren.

Windsurf / OpenCode

Genehmigen MCP-Tools standardmäßig automatisch — keine zusätzliche Konfiguration nötig.

Warum ist das sicher?

Planu liest und schreibt nur Dateien im planu/-Ordner deines Projekts. Es führt niemals Code aus, greift nicht auf das Internet zu und ändert keine Quelldateien.

Manuelle Installation (für nicht unterstützte Tools oder benutzerdefinierte Setups)

{
  "mcpServers": {
    "planu": {
      "command": "npx",
      "args": ["--prefer-online", "-y", "@planu/cli@latest"]
    }
  }
}

Claude Code:

claude mcp add planu -- npx -y @planu/cli@latest

Cursor: ~/.cursor/mcp.json öffnen oder erstellen und den Konfigurationsblock einfügen.

Windsurf: ~/.windsurf/mcp.json öffnen oder erstellen und den Konfigurationsblock einfügen.

OpenCode: ~/.config/opencode/config.json öffnen oder erstellen und einfügen:

{
  "mcp": {
    "planu": { "type": "local", "command": ["planu", "serve"], "enabled": true }
  }
}

Gemini CLI: ~/.gemini/settings.json öffnen oder erstellen und den Konfigurationsblock einfügen.

Codex / AGENTS.md:

planu install --codex     # injiziert Anweisungen in AGENTS.md

Dein erstes Projekt

Nach der Installation startest du einfach ein Gespräch mit deinem KI-Assistenten. Keine Befehle auswendig lernen.

Beispiel: "Ich möchte Google-Login zu meiner App hinzufügen"

Das ist alles. Sag, was du willst. Planu erledigt automatisch:

1. Dein Projekt analysieren — erkennt deinen Tech-Stack, vorhandenen Code und Struktur
2. Einen detaillierten Plan erstellen — eine Spec mit Akzeptanzkriterien, Aufwandsschätzung und technischem Ansatz
3. Deine Genehmigung einholen — du prüfst den Plan und kannst ihn genehmigen, Änderungen anfragen oder ablehnen
4. Den Plan umsetzen — Code wird gemäß der genehmigten Spec geschrieben
5. Das Ergebnis validieren — prüft, ob die Implementierung dem Plan entspricht

Weitere Beispiele

• "Bau mir ein Zahlungssystem mit Stripe"
• "Füge einen Dunkel-Modus-Schalter zur Einstellungsseite hinzu"
• "Behebe den Fehler, wo Benutzer keine großen Dateien hochladen können"
• "Refaktoriere das Authentifizierungsmodul auf JWT"
• "Ich brauche einen API-Endpunkt für Benutzerprofile"

Du behältst immer die Kontrolle

• Genehmige oder lehne ab — jeder Plan wird vorgelegt, bevor Code geschrieben wird
• Fordere Änderungen an — "mach es einfacher" oder "füge Rate-Limiting hinzu"
• Überspringe den Workflow — "füge einfach ein console.log hinzu" funktioniert auch
• Verfolge den Fortschritt — Planu behält den Überblick

Das ist das ganze Tutorial. Installieren, reden, bauen. Planu erledigt den Rest.

Dein KI-Ökosystem — Automatische Konfiguration für jedes Tool

ai_ecosystem_status — Gesundheitscheck für jedes KI-Tool

Prompt: "What is the health of my AI ecosystem?"

sync_ai_configs — Alles auf einmal reparieren

Prompt: "Sync my AI configs"

Eine Installation, null Konfigurationsaufwand

Führe sync_ai_configs einmal nach der Installation aus. Jedes KI-Tool ist sofort für spec-driven Development konfiguriert.

Nächste Schritte

• Den vollständigen SDD-Workflow verstehen →
• Alle Planu-Tools erkunden →
• Praxisrezepte ansehen →