Docs

Documentación de Orbit

Todo lo que necesitas para instalar Orbit, ejecutar sesiones del agente, trabajar con worktrees de Git, conectar servidores MCP y aprender el teclado.

Qué es Orbit

Orbit es un banco de trabajo de escritorio nativo para el agente de código pi. Es una app en Rust dibujada con GPUI, el framework de interfaz acelerado por GPU que hay detrás de Zed: sin navegador, sin webview, sin capa de interfaz Node.

Orbit no es un envoltorio de chat sobre una API de modelos. Lanza la CLI pi como proceso hijo y habla el propio protocolo RPC de pi por stdio. El catálogo de modelos, las herramientas, los niveles de pensamiento y las sesiones siguen siendo de pi; Orbit es la ventana hacia ellos. Una sesión creada en Orbit y otra creada en el terminal son el mismo archivo.

Cómo funciona

Orbit (Rust · GPUI)
   │  JSON RPC delimitado por líneas sobre stdio
   ▼
CLI de pi (un proceso hijo por sesión abierta)
   │
   ▼
~/.pi/agent/   sesiones · configuración · uso

Las peticiones van a pi como JSON por stdin; pi devuelve eventos como líneas JSON por stdout: deltas de texto y de pensamiento, llamadas a herramientas, diálogos de preguntas y señales de cierre. Como el runtime es pi, todo lo que hace la CLI lo puede manejar Orbit, y nada se reimplementa dos veces.

Qué necesitas

  • pi — la CLI del agente de código que hace el trabajo. Instálala desde el repositorio de pi.
  • Node.js — lo necesitan muchos servidores MCP (ejecutados con npx) y los paquetes de pi.
  • Git — impulsa el panel Review, la página Git y los worktrees.

En el primer arranque, Orbit comprueba los tres y avisa de lo que falte junto con el comando para instalarlo. Puedes volver a verlo cuando quieras desde Ajustes.

Dónde viven tus datos

RutaQué hay ahí
~/.pi/agent/sessions/Tus sesiones: los mismos archivos que lee y escribe la CLI pi.
~/.pi/agent/Configuración de pi, incluida su configuración de MCP y sus credenciales.
~/.orbit-pi/Preferencias de Orbit: diseño, modo de acceso, modo de flujo de trabajo, notificaciones, la raíz de worktrees y el almacén de secretos de MCP.
<project>/.pi/Configuración de pi por proyecto, incluido un mcp.json del proyecto.

Guías

¿Falta algo? Abre un issue en GitHub.