关于 orbit
Orbit 是面向编码 Agent 的本地优先运行时,用于管理任务并执行受控交付。它结合隔离工作树、并行运行锁、审批门控和审计记录,且不依赖云服务或向其提供 API 密钥。
主要功能
- 01持久化任务队列与审计记录
- 02隔离工作树与文件锁
- 03计划、执行、审查门控流程
- 04交付流程与拉取请求支持
- 05多 Agent 并行编排
- 06仪表板、插件与 Agent 技能
适用场景
- 01将需求转为带验收标准的任务
- 02并行执行多个编码任务
- 03在合并变更前审查 Agent 产出
- 04追踪任务提示词、执行记录和审查结果
MCP 相关
Orbit 可连接 MCP,并提供 MCP 工具;每个工具也有对应的命令行版本。文档还介绍了跨多台机器的联邦 MCP。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Agent 编写。Orbit 交付。
Orbit 是一款本地优先的编码 Agent 运行时。继续使用已完成身份验证的 Agent CLI;Orbit 会提供持久化任务队列、沙盒化工作树、用于并行运行的文件锁、带审核关卡的交付流水线和审计日志。
**原因:**快速的 Agent 容易让规划、评审和可追溯性被忽视。Orbit 会保留每项变更背后的提示词、计划和评审,并为每次工作流提交附上任务 ID。
- **单一二进制文件,无需云服务。**状态保存在
~/.orbit和.orbit/中;Orbit 不会发送遥测数据。 - **自带 Agent。**使用你已完成身份验证的提供商 CLI,无需向 Orbit 提供 API 密钥。
- **采用 MIT 许可。**没有付费层级或托管服务。
工作原理
You: The fsProfile lookup is undocumented. Get that fixed.
Agent: Files a proposed task with acceptance criteria. Approve it and ship?
You: Yes.
Agent: Queues it, then runs plan → execute → review in a locked, isolated worktree.
Opens a pull request. Review and merge it, then approve the task to close it.
未经批准不会启动任何任务;PR 运行会暂停,等待你评审,除非你授权使用 --complete。任务记录会保留提示词、计划、执行轨迹和评审。对于较大的规格说明,可让你的 Agent 编排任务:内置的 orbit-orchestrate 技能会拆分工作,在获批后将任务加入队列,并行运行并诊断故障(交付工作流)。
快速开始
你需要: macOS 或 Linux(x64 或 arm64;Windows 使用 WSL2)、Node 18+、已通过身份验证的 Agent CLI,以及用于拉取请求的已通过身份验证的 gh。
npm install -g @orbit-tools/cli
orbit init # machine name, task-ID prefix, agent skills, and Linux sandbox setup
在仓库中打开你的 Agent,并让它**“为此仓库设置 Orbit”。捆绑的 orbit-setup 技能会注册 Orbit、连接 MCP、运行 orbit doctor,并询问 PR 目标分支等选项。启动一个新的 Agent 会话,然后询问:“添加一个内容为 hello 的 hello.txt 文件;将其登记为 Orbit 任务。”** 按提示批准并交付任务,审查并合并 PR,然后批准任务以将其关闭。运行 orbit web serve 进行监控。
更喜欢插件?为 Claude Code、Codex 或 Cursor 安装 Orbit。每个 MCP 工具都有对应的 CLI;如果想在不使用 Agent 的情况下完成相同流程,请参阅在终端中创建你的第一个任务。
手动设置仓库
cd <repo> && orbit workspace init --mcp # add --ship-mode local to skip PRs
orbit doctor
orbit web serve
在首次交付前,审查并提交 workspace init 列出的检出文件,包括 MCP 客户端文件。本地交付会拒绝已跟踪文件的更改、合并冲突,以及与传入更改重叠的未跟踪路径。
orbit doctor 会检查默认、系统和按复杂度路由的执行组中是否存在 CLI;如果未注册 MCP 客户端,则会发出警告。它不会检查提供商登录状态或 MCP 连接状态。使用 orbit doctor providers 检查所有执行器定义。请参阅 Linux 沙盒就绪情况和发行版覆盖范围。
| 要… | 运行 |
|---|---|
| 查看任务或运行 | orbit task show <ID> · orbit run show <RUN_ID> |
| 打开仪表盘 | orbit web serve(远程:orbit web connect <host>) |
| 在桌面窗口中打开仪表盘 | 在 desktop/ 中构建应用 |
| 选择默认执行组(提供商和模型) | orbit config set workflow.default_crew <crew> |
| 按复杂度将任务路由到执行组 | orbit config set --global workflow.hard_complexity_crews '["opus"]'(更多信息) |
| 升级 | npm install -g @orbit-tools/cli@latest(orbit update --check 可查看更新内容) |
功能
- 规划与治理:持久化任务、审计记录、摩擦机制和本地搜索。
- 安全地并行执行:沙盒、锁、带门控的流水线,以及八种 Agent CLI。
- 无人值守运行:有界任务队列、可选完成机制、定期审查和多台机器。
- 观察与扩展:仪表盘、插件和捆绑的 Agent 技能。
执行组和复杂度路由
执行组用于指定提供商、模型和工作量等级;如果任务未显式指定执行组,复杂度池会为其选择一个。请参阅执行组定义、init 初始化的复杂度池,以及复杂度路由、权重和覆盖项。
MCP 和权限
连接你的 Agent 说明操作员和仅 Agent 权限;联邦 MCP 可连接多台机器。
状态存储位置
作用域规则 说明机器和工作区状态。备份、恢复和升级信息请参阅运行手册。
了解更多
- orbit-cli.com: 指南、概念,以及完整的 CLI 和配置参考
- docs/CONFIG.md: 工作组、资源池、基础分支、沙盒
- docs/POSITIONING.md: Orbit 的用途,以及它刻意不涉及的内容
- docs/OPTIMISTIC_MERGING.md: 首选交付模式:快速合并、合并后审查,并保持队列持续处理
- ARCHITECTURE.md 和 设计文档
- CHANGELOG.md: Orbit 尚未达到 1.0 版本,次要版本会发布破坏性变更
贡献
欢迎提交拉取请求,从修正错别字到新增执行器都可以。小修复可以直接提交 PR;较大的改动请从创建议题开始。请参阅 CONTRIBUTING.md。
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。