pi-delegate

Delegiere Implementierung und Tests an einen lokalen pi-Agenten, mit Hooks, die Disziplin bei der Aufgabenverteilung durchsetzen.

Claude agiert als Tech Lead: Es erstellt den Probe, das Aufgabenbuch, das Abnahmeskript und das Urteil. pi schreibt den Quellcode.

Claude spricht das RPC-Protokoll nie direkt — der MCP-Server hält die Pipe, was pi_steer und pi_abort während des Laufs möglich macht.

Installation

/plugin marketplace add LarryStanley/pi-delegate
/plugin install pi-delegate@pi-delegate

Beides in Claude Code ausführen. Der erste Befehl registriert dieses Repository als Plugin-Marketplace; der zweite installiert das Plugin daraus. Wenn die Installationsübersicht Run /reload-plugins to activate. anzeigt, auch das ausführen.

Erfordert Node ≥ 22 und eine pi-Installation, die bereits eingerichtet ist. Abhängigkeiten werden automatisch aus der eingecheckten Lockfile installiert — es gibt nichts, was man selbst npm install müsste.

Für spätere Updates:

/plugin marketplace update pi-delegate

Um eine Arbeitskopie statt der veröffentlichten Version auszuführen:

claude --plugin-dir /path/to/pi-delegate

Eine --plugin-dir-Kopie hat für diese Sitzung Vorrang vor der installierten, sodass man Änderungen testen kann, ohne zu deinstallieren.

Danach /pi-delegate:setup für eine geführte Ersteinrichtung ausführen: Sie prüft pi und dessen Provider, erklärt die Disziplin-Modi und fragt, welchen man möchte, bietet an, alles Reparierbare zu reparieren, und bietet eine Verifikations-Dispatch an, bevor man die Tools wirklich nutzt.

Related MCP server: Claude Code Manager WAN

Konfiguration: Standardmäßig ist nichts erforderlich

pi_dispatch gibt keinen Provider oder kein Modell an, sodass pi die eigenen Standardwerte verwendet (defaultProvider / defaultModel in ~/.pi/agent/settings.json). Mit anderen Worten: Welches Modell auch immer pi bereits zugewiesen ist, dorthin gehen auch Dispatches — anthropic, openai, litellm, ollama, LM Studio oder ein lokaler OpenAI-kompatibler Server (z. B. omlx) funktionieren alle auf dieselbe Weise, ohne dass für dieses Plugin speziell etwas konfiguriert werden müsste.

Wenn man langfristig ein anderes Modell festlegen möchte (z. B. ein günstiges lokales Modell, das nur für Dispatches zuständig ist, während interaktives pi etwas anderes verwendet), schreibt man ~/.claude/pi-delegate/config.json:

{
  "provider": "ollama",
  "model": "qwen3:8b",
  "timeout_s": 1500,
  "thinking": "off",
  "tools": "read,write,edit",
  "no_context_files": true,
  "drafter_patterns": ["-draft", "_assistant", "-assistant"]
}

Jedes Feld ist optional. Die Auflösungsreihenfolge ist pi_dispatch-Aufrufargumente → diese Datei → pis eigene Standardwerte.

/pi-delegate:doctor zeigt an, welches Modell ein Dispatch tatsächlich erreicht, und meldet ein Problem nur unter Bedingungen, die tatsächlich zutreffen.

Die folgenden Standardwerte wurden gemessen, nicht geraten

Zum Überschreiben direkt im pi_dispatch-Aufruf angeben (thinking, tools, no_context_files, append_system_prompt, provider, model, timeout_s).

--mode rpc, --session-id, --no-skills und --no-extensions sind strukturell und nicht überschreibbar; --no-session wird bewusst nie übergeben (das Weglassen ist es, was die Sitzung auf der Festplatte landen lässt, was pi_transcript etwas zum Lesen gibt).

Modi

Modi wechseln mit /pi-delegate:mode <mode>; der Zustand liegt in ~/.claude/pi-delegate/modes.json, pro Projekt gespeichert. „Bestehender Produktcode" bedeutet eine Quelldatei, die bereits unter dem Projektstamm in src/ existiert; tasks/, scripts/, docs/, Markdown, Konfigurationsdateien und brandneue Dateien werden alle durchgelassen.

strict ist ein Disziplin-Schutzzaun, keine Durchsetzung: Der Hook ist nur an Write|Edit angebunden, sodass das Bearbeiten derselben Datei mit Bash (sed -i, ein Heredoc, python - <<EOF, …) nie abgefangen wird. Es gibt immer einen Weg darum herum — es blockiert das Bearbeiten der Datei aus Gewohnheit, nicht einen bewussten Workaround.

Für eine manuelle Bearbeitung (einen Probe) zuerst /pi-delegate:probe für eine einmalige Umgehung ausführen.

MCP-Tools

Wie ein Dispatch funktioniert

Die Aktivierung des MCP-Servers erstreckt sich über die gesamte Sitzung; deshalb kann er dem pi-Kindprozess mitten im Lauf noch ein steer an dessen stdin liefern, und deshalb entscheidet er — nicht der Kindprozess — wann der Lauf vorbei ist.

Bekannte Lücken

pi_stats gibt nur die tokens und duration_s zurück, die bereits im Urteil enthalten sind. Der get_session_stats-Passthrough aus spec §5 (einschließlich cost / context-Nutzung) ist noch nicht implementiert.

Dokumentation

Entwicklung

npm test                    # node --test, no external dependencies
claude plugin validate .

fixtures/fake-pi.mjs vertritt pi --mode rpc. Es liegt bewusst außerhalb von test/ — node --test behandelt jede Datei unter **/test/**/*.{cjs,mjs,js} als Testdatei, und es in test/ zu legen würde einen dauerhaft grünen Phantom-Test hinzufügen.