Docs

Documentation d'Orbit

Tout ce qu'il faut pour installer Orbit, lancer des sessions d'agent, travailler avec les worktrees Git, connecter des serveurs MCP et apprendre le clavier.

Ce qu'est Orbit

Orbit est un atelier de bureau natif pour l<pi>agent de code pi</pi>. Cest une application Rust dessinée avec GPUI, le framework d'interface accéléré par GPU derrière Zed — pas de navigateur, pas de webview, pas de couche d'interface Node.

Orbit n'est pas un habillage de chat autour d'une API de modèle. Il lance la CLI pi comme processus enfant et parle le protocole RPC de pi sur stdio. Le catalogue de modèles, les outils, les niveaux de réflexion et les sessions restent ceux de pi ; Orbit est la fenêtre dessus. Une session créée dans Orbit et une créée dans le terminal sont le même fichier.

Comment ça marche

Orbit (Rust · GPUI)
   │  RPC JSON délimité par lignes sur stdio
   ▼
CLI pi (un processus enfant par session ouverte)
   │
   ▼
~/.pi/agent/   sessions · configuration · usage

Les requêtes partent vers pi en JSON sur stdin ; pi renvoie des événements en lignes JSON sur stdout — deltas de texte et de réflexion, appels d'outils, dialogues de questions et signaux de fin. Comme le runtime est pi lui-même, tout ce que fait la CLI, Orbit peut le piloter, et rien n'est réimplémenté deux fois.

Ce qu'il vous faut

  • pi — la CLI de l'agent de code qui fait le travail. Installez-la depuis le dépôt pi.
  • Node.js — nécessaire à beaucoup de serveurs MCP (lancés via npx) et aux paquets pi.
  • Git — alimente le panneau Review, la page Git et les worktrees.

Au premier lancement, Orbit vérifie les trois et signale ce qui manque, avec la commande pour l'installer. Vous pouvez revoir cela à tout moment depuis les Réglages.

Où vivent vos données

CheminCe qui s'y trouve
~/.pi/agent/sessions/Vos sessions — les mêmes fichiers que lit et écrit la CLI pi.
~/.pi/agent/Configuration de pi, y compris sa configuration MCP et ses identifiants.
~/.orbit-pi/Préférences d'Orbit : disposition, mode d'accès, mode de flux de travail, notifications, la racine des worktrees et le coffre de secrets MCP.
<project>/.pi/Configuration pi propre au projet, dont un mcp.json de projet.

Guides

Premiers pas

InstallationTéléchargez la version de votre plateforme, passez les vérifications du premier lancement et envoyez un premier prompt.

Espace de travail

SessionsProjets, sessions, navigation, flux de travail et modes d'accès, et notifications.WorktreesFaites tourner des branches en parallèle comme de vrais espaces de travail, avec un script de préparation facultatif.Serveurs MCPGérez les serveurs Model Context Protocol que l'agent peut appeler, avec un coffre de secrets local.

Garde-fous

Modes d'accèsSupervisé, Accepter les modifications automatiquement et Accès complet : ce qui s'exécute sans demander, et comment fonctionnent les approbations.

Référence

Raccourcis clavierTous les raccourcis, groupés par la surface où ils agissent.

Il manque quelque chose ? Ouvrez une issue sur GitHub.

SuivantInstallation