Orbit 文档

Orbit 是什么

Orbit 是面向pi 编程智能体的原生桌面工作台。它是一款用 GPUI 绘制的 Rust 应用 —— GPUI 是 Zed 背后那套 GPU 加速的界面框架 —— 没有浏览器，没有 webview，也没有 Node 界面层。

Orbit 不是套在模型 API 外面的聊天壳。它把 pi CLI 作为子进程启动，通过 stdio 使用 pi 自己的 RPC 协议。模型目录、工具、思考等级和会话都归 pi 所有；Orbit 是照见它们的窗口。你在 Orbit 中创建的会话和在终端中创建的会话是同一个文件。

工作原理

Orbit (Rust · GPUI)
   │  基于 stdio 的按行 JSON RPC
   ▼
pi CLI（每个打开的会话一个子进程）
   │
   ▼
~/.pi/agent/   会话 · 配置 · 用量

请求以 JSON 通过 stdin 发给 pi；pi 把事件以 JSON 行从 stdout 流回来 —— 文本与思考增量、工具调用、提问对话框和结束信号。因为运行时就是 pi 本身，CLI 能做的事 Orbit 都能驱动，没有任何逻辑被实现两遍。

你需要什么

• pi —— 真正干活的编程智能体 CLI。从 pi 仓库安装。
• Node.js —— 许多 MCP 服务器（通过 npx 运行）和 pi 包都需要它。
• Git —— 支撑 Review 面板、Git 页面和工作树。

首次启动时 Orbit 会检查这三项，并列出找不到的项目以及安装命令。你随时可以在设置中重新查看。

数据在哪里

指南

缺少什么？在 GitHub 上开一个 issue。