Документация

Документация Orbit

Всё, что нужно, чтобы установить Orbit, запускать сессии агента, работать с worktree в Git, подключать серверы MCP и освоить клавиатуру.

Что такое Orbit

Orbit — нативная рабочая среда для агента-программиста pi. Это приложение на Rust, отрисованное через GPUI, ускоренный GPU UI-фреймворк, на котором построен Zed. Без браузера, без webview, без слоя интерфейса на Node.

Orbit — не чат-обёртка над API моделей. Он запускает CLI pi как дочерний процесс и говорит на собственном RPC-протоколе pi через stdio. Каталог моделей, инструменты, уровни размышления и сессии остаются у pi; Orbit — окно в них. Сессия, созданная в Orbit, и сессия, созданная в терминале, — один и тот же файл.

Как это работает

Orbit (Rust · GPUI)
   │  JSON RPC, по одному объекту на строку, через stdio
   ▼
pi CLI (один дочерний процесс на открытую сессию)
   │
   ▼
~/.pi/agent/   сессии · конфигурация · статистика

Запросы уходят в pi как JSON в stdin; pi возвращает события строками JSON в stdout — дельты текста и размышления, вызовы инструментов, диалоги вопросов и сигналы завершения. Поскольку среда выполнения — сам pi, всё, что умеет CLI, умеет и Orbit, и ничего не реализовано дважды.

Что нужно

  • pi — CLI агента-программиста, который делает работу. Установите его из репозитория pi.
  • Node.js — нужен многим серверам MCP (запускаются через npx) и пакетам pi.
  • Git — обеспечивает панель Review, страницу Git и worktree.

При первом запуске Orbit проверяет все три и сообщает об отсутствующих вместе с командой установки. Вернуться к этому можно в любой момент в настройках.

Где хранятся данные

ПутьЧто там
~/.pi/agent/sessions/Ваши сессии — те же файлы, которые читает и пишет CLI pi.
~/.pi/agent/Конфигурация pi, включая настройки MCP и учётные данные.
~/.orbit-pi/Настройки Orbit: раскладка, режим доступа, режим рабочего процесса, уведомления, корень worktree и хранилище секретов MCP.
<project>/.pi/Конфигурация pi уровня проекта, включая mcp.json проекта.

Руководства

Чего-то не хватает? Откройте issue на GitHub.