Doku

Orbit-Dokumentation

Alles, was du brauchst, um Orbit zu installieren, Agentensitzungen zu fahren, mit Git-Worktrees zu arbeiten, MCP-Server anzubinden und die Tastatur zu lernen.

Was Orbit ist

Orbit ist eine native Desktop-Arbeitsumgebung für den pi Coding-Agent. Es ist eine Rust-App, gezeichnet mit GPUI, dem GPU-beschleunigten UI-Framework hinter Zed — kein Browser, kein Webview, keine Node-UI-Schicht.

Orbit ist kein Chat-Wrapper um eine Modell-API. Es startet die pi-CLI als Kindprozess und spricht pis eigenes RPC-Protokoll über stdio. Modellkatalog, Tools, Denkstufen und Sitzungen bleiben die von pi; Orbit ist das Fenster darauf. Eine Sitzung, die du in Orbit anlegst, und eine im Terminal sind dieselbe Datei.

Wie es funktioniert

Orbit (Rust · GPUI)
   │  zeilenweise abgegrenztes JSON-RPC über stdio
   ▼
pi CLI (ein Kindprozess pro offener Sitzung)
   │
   ▼
~/.pi/agent/   Sitzungen · Konfiguration · Nutzung

Anfragen gehen als JSON über stdin an pi; pi streamt Ereignisse als JSON-Zeilen über stdout zurück — Text- und Denk-Deltas, Werkzeugaufrufe, Rückfrage-Dialoge und Settle-Signale. Weil die Laufzeit pi selbst ist, kann Orbit alles steuern, was die CLI kann, und nichts wird doppelt implementiert.

Was du brauchst

  • pi — die Coding-Agent-CLI, die die Arbeit macht. Installiere sie aus dem pi-Repository.
  • Node.js — wird von vielen MCP-Servern (ausgeführt über npx) und von pi-Paketen gebraucht.
  • Git — treibt das Review-Panel, die Git-Seite und Worktrees.

Beim ersten Start prüft Orbit alle drei und meldet Fehlendes samt Befehl zum Installieren. Du kannst das jederzeit in den Einstellungen erneut ansehen.

Wo deine Daten liegen

PfadWas dort liegt
~/.pi/agent/sessions/Deine Sitzungen — dieselben Dateien, die die pi-CLI liest und schreibt.
~/.pi/agent/pi-Konfiguration, inklusive MCP-Konfiguration und Zugangsdaten.
~/.orbit-pi/Orbit-Einstellungen: Layout, Zugriffsmodus, Workflow-Modus, Benachrichtigungen, das Worktree-Wurzelverzeichnis und der MCP-Secret-Speicher.
<project>/.pi/Projektgebundene pi-Konfiguration, inklusive einer mcp.json im Projekt.

Anleitungen

Fehlt etwas? Öffne ein Issue auf GitHub.