Docs

Documentação do Orbit

Tudo o que você precisa para instalar o Orbit, rodar sessões do agente, trabalhar com worktrees do Git, conectar servidores MCP e aprender o teclado.

O que é o Orbit

O Orbit é um ambiente de trabalho desktop nativo para o agente de código pi. É um app em Rust desenhado com GPUI, o framework de interface acelerado por GPU por trás do Zed — sem navegador, sem webview, sem camada de interface em Node.

O Orbit não é um invólucro de chat em volta de uma API de modelos. Ele inicia a CLI pi como processo filho e fala o próprio protocolo RPC do pi por stdio. O catálogo de modelos, as ferramentas, os níveis de pensamento e as sessões continuam sendo do pi; o Orbit é a janela para eles. Uma sessão criada no Orbit e uma criada no terminal são o mesmo arquivo.

Como funciona

Orbit (Rust · GPUI)
   │  JSON RPC delimitado por linhas sobre stdio
   ▼
CLI do pi (um processo filho por sessão aberta)
   │
   ▼
~/.pi/agent/   sessões · configuração · uso

As requisições vão para o pi como JSON no stdin; o pi devolve eventos como linhas JSON no stdout — deltas de texto e de pensamento, chamadas de ferramentas, diálogos de pergunta e sinais de encerramento. Como o runtime é o próprio pi, tudo o que a CLI faz o Orbit consegue conduzir, e nada é reimplementado duas vezes.

Do que você precisa

  • pi — a CLI do agente de código que faz o trabalho. Instale pelo repositório do pi.
  • Node.js — necessário para muitos servidores MCP (rodados via npx) e para pacotes do pi.
  • Git — sustenta o painel Review, a página Git e as worktrees.

Na primeira execução o Orbit verifica os três e informa o que faltar junto com o comando para instalar. Você pode rever isso a qualquer momento nas Configurações.

Onde ficam seus dados

CaminhoO que há ali
~/.pi/agent/sessions/Suas sessões — os mesmos arquivos que a CLI pi lê e grava.
~/.pi/agent/Configuração do pi, incluindo a configuração de MCP e as credenciais.
~/.orbit-pi/Preferências do Orbit: layout, modo de acesso, modo de fluxo de trabalho, notificações, a raiz das worktrees e o cofre de segredos de MCP.
<project>/.pi/Configuração do pi por projeto, incluindo um mcp.json do projeto.

Guias

Falta algo? Abra uma issue no GitHub.