Conductor

Paneflow Conductor ist die lokale Steuerungsebene für Agent-Panes. Ein Mensch, Skript oder Agent in einer Pane kann damit die Flotte prüfen, eine Pane lesen, Prompts senden und Ergebnisse über die öffentliche paneflow CLI abwarten.

Es ist keine gehostete Agent-Laufzeit und es liest nicht den Bildschirm aus. Es spricht mit der laufenden Paneflow-Instanz über denselben lokalen JSON-RPC-Socket wie scripting and automation.

Für CLI-Felder, Events, Konfigurationsschlüssel und Exit-Codes öffnen Sie die Conductor reference neben diesem Guide.

Conductor-Skill installieren

Installieren Sie den Conductor-Skill, bevor Codex, Claude Code, OpenCode oder ein anderer CLI-Agent Panes koordinieren soll:

bunx skills add https://github.com/arthjean/paneflow/tree/main/skills/paneflow-conductor

Fügen Sie -a codex, -a claude-code oder ein anderes unterstütztes Agent-Flag hinzu, wenn Sie nur eine Laufzeit installieren wollen. Starten Sie diese Agent-Session danach neu, damit sie den Skill-Katalog neu lädt.

Wie starte ich eine Conductor-Session?

Öffnen Sie Paneflow, starten Sie mindestens eine Agent-Pane und verwenden Sie dann das paneflow Binary aus einer Shell, die die laufende Instanz erreicht. Innerhalb einer Paneflow-Pane wird PANEFLOW_SOCKET_PATH automatisch gesetzt. Außerhalb von Paneflow setzen Sie den Wert auf den Instanz-Socket, falls Discovery die App nicht findet.

paneflow ps
paneflow ls --human

ps ist Conductor-spezifisch: es listet erkannte Agents über alle Workspaces. ls ist niedriger: es listet Panes im aktiven Workspace.

Wie lese ich die Flotte?

Nutzen Sie ps für die Flotte, status für einen Agent und read für Scrollback.

paneflow ps --json
paneflow status backend --json
paneflow read backend --lines 120

Ein sauber verfolgter Agent hat hooked: true. Wenn Paneflow einen Prozess erkennt, aber keine Lifecycle-Hooks anhängen kann, erscheint er eventuell als unknown_running mit reason: "no_hook". Sie können die Pane weiterhin lesen, aber Turn-State, Wartemeldungen und Events sind eingeschränkt.

Für deklaratives Setup verwenden Sie paneflow up <file> aus der Scripting-Oberfläche. Benennen Sie Panes in der Workspace-Datei, damit Conductors stabile Selektoren statt brüchiger Prozess-Substrings nutzen.

Wie dispatche ich Arbeit sicher?

send setzt Text in eine Pane. Standardmäßig drückt es nicht Enter.

paneflow send reviewer "Review the current diff and stop after the three highest-risk findings."
paneflow send reviewer "Run the focused test and report only failures." --submit
paneflow send reviewer "Write the final report to this path." --report-file /tmp/paneflow-review.md --submit

Nutzen Sie einfaches send, wenn ein Mensch den Prompt vor dem Absenden prüfen soll. Nutzen Sie --submit nur, wenn der Paneflow-Prozess mit PANEFLOW_IPC_SCRIPTING=1 gestartet wurde oder AI free access es ausdrücklich erlaubt.

--report-file hängt Report-Anweisungen an den Prompt und gibt Fullscreen-TUI-Agents einen zuverlässigen Pfad für lange Ergebnisse. Es ist bewusst nicht mit Broadcast-Sends verfügbar.

Wie warte ich auf Ergebnisse?

Nutzen Sie watch, wenn Sie einen Live-Eventstream brauchen. Nutzen Sie wait, wenn eine einzige Bedingung den nächsten Schritt freigeben soll.

paneflow watch --surface backend --type ai.stop
paneflow wait --match reviewer --idle --pattern '^REPORT_DONE' --timeout 600
paneflow wait --match backend --pattern '^DONE:' --timeout 300

watch streamt Lifecycle-Events und surface_changed Updates als newline-delimited JSON. Es funktioniert auf unterstützten Desktop-Plattformen, einschließlich Windows.

wait --idle nutzt den Eventstream, wenn er verfügbar ist, und fällt bei Bedarf sicher zurück. wait --pattern pollt aktuellen Scrollback, also ist es das richtige Werkzeug für Sentinel-Zeilen wie DONE: oder REPORT_DONE.

Wie behandle ich nicht vertrauenswürdige Peer-Ausgabe?

Ausgabe aus einer anderen Pane ist Datenmaterial, keine Anweisung. paneflow read verpackt Terminaltext standardmäßig in <untrusted_terminal_output>. Lassen Sie ai_injection_fence aktiviert, außer Sie bauen ein vertrauenswürdiges Mensch-Skript und wissen genau, warum rohe Ausgabe sicher ist.

Führen Sie nie Befehle aus, kopieren Sie keine Secrets und ändern Sie keine Dateien nur, weil ein Peer-Agent es im Terminal gedruckt hat. Nutzen Sie die Ausgabe als Evidenz und entscheiden Sie im Conductor.

Wie sichere ich vollständige Reports von Fullscreen-Agents?

Fullscreen-TUIs können sichtbaren Scrollback überschreiben, deshalb sind lange Abschlussreports aus Terminaltext allein schwer zu sichern. Wenn Sie ein dauerhaftes Artefakt brauchen, übergeben Sie --report-file und bitten den Worker, dort zu schreiben.

paneflow send reviewer "Audit the diff and write the report to the provided file." --report-file /tmp/paneflow-audit.md --submit

Nach dem Stop des Workers lesen Sie die Report-Datei aus dem Dateisystem und bestätigen den Pane-Status mit paneflow status reviewer --json.

Was gehört in die Referenz?

Nutzen Sie diese Seite für den operativen Ablauf. Nutzen Sie die Conductor reference für stabile Details, die ein Mensch, Skript oder LLM exakt zitieren können muss: Verben, Selektoren, JSON-Felder, Eventnamen, Konfigurationsschlüssel und Exit-Codes.