1,000
stars
66
forks
4
watchers
53
prs
24
issues
63
releases
README
English · 简体中文
任务进行到一半,Claude Code余额用完了,Codex在同一个对话直接接手。
Orbital
project agent(项目 agent)
Agent只负责一次会话,Orbital负责整个项目。
Orbital是一个agent上下文管家,帮助你维护项目上下文,让所有agent在同一份上下文上工作。任何agent的产出和沉淀,都会给所有agent复用。
上下文是你的,agent是可替换的。
Orbital 使用教程。
1 分钟演示:切换agent,项目继续进行
https://github.com/user-attachments/assets/88cf118c-1dd9-4429-897d-f2003de3049d
!Platform: Windows !Platform: macOS
---
为什么你需要一个“project” agent
你的上下文,是你的吗?
你正在和 Claude Code 讨论一个方案,聊到第三轮,它弹出「You're out of usage credits」。Codex 的额度还在,但 Codex 对这个项目一无所知——目标、前两轮拍板的结论、改到一半的文件,都得你重讲一遍。
每个 agent 还剩多少额度,就写在选择器里。换一个,它从同一份项目上下文接着做。
不只是额度。在工作中,大家都已经在同时用好几个 agent —— 可能是因为新出的模型、剩余的额度,也可能是因为某个工具更擅长这类活。但 Claude Code 里定下的方案、Codex 改到一半的文件、Cursor 里拍板的取舍——各自锁在各自的会话里。会话一关、换个工具,上下文就无法使用。
于是把项目「搬运」过去的活就落到了你身上:重述目标、解释此前的决策、翻找产出的文件、确认还有什么没做完。
你才是 agent 的实习生:复制粘贴、搬运上下文、记住杂七杂八的文件放在哪,让agent来做脑力活。
Orbital 把上下文从会话里拿出来,放回你的本地文件夹,把工作的单位从「会话」换成「项目」。
project agent记录下项目中所有agent的进度,保证下一个agent有充分的上下文接手任务。任何agent的产物和沉淀,都会被所有agent参考和复用。不需要重新发明轮子,所有agent在同一个项目上自进化。
单个 agent 完成任务。Orbital 推动整体项目进展。
---
什么叫“对你的项目负责”
Orbital将把重要的项目上下文组织起来,以普通文件的形式维护在你的本地文件夹里:
- 状态 —— 项目现在是什么情况(PROJECT_STATE.md)
- 决策 —— 决定了什么、为什么这么定(DECISIONS.md)
- 经验教训 —— 项目一路上学到了什么(LESSONS.md)
- 产出成果 —— agent 调研、撰写、构建出来的东西(工作空间本身,以及 orbital/output/)
这些都留会成为后续工作的上下文。每次任务开始前,Orbital 会先把它们组装进自己的系统提示词中,保证没有遗漏。
子agent也会读取同一批文件,不需要你记住项目的信息和文件架构。Agent会自己做笔记,保证下一次会话能无缝衔接。
Agent可以换。你的上下文资产一直在。
---
微信扫码加我,拉你进用户反馈群
快速开始
展开 4 步上手流程(带截图)
每一步都带截图的完整教程见 Orbital 使用教程:配置 API key、新建项目、切换子 Agent、任务队列、自动任务和项目设置。
1. 启动 Orbital —— 设置向导依次引导你完成四步:先确认 Orbital 在本机找到的编码 agent,再把你和这些 agent 做过的项目导入进来(都可跳过),然后配置 API 密钥和关联账户。
Step 3 — LLM Provider: 中国大陆用户点「一键登录词元跳动」,授权后免费领取 Token,直接开始。也可以从预设卡片里选择服务商,点「获取 API 密钥」直达密钥控制台,粘贴即可——支持 DeepSeek、Moonshot (Kimi)、智谱、MiniMax、Anthropic、OpenAI 等十余家服务商。
Step 4 — 关联账户: 连接 API 连接器(Google Calendar、Drive),并提前登录 agent 需要访问的站点(Google、GitHub 等),防止它在浏览时被验证码挡住。这一步可跳过,之后随时可在设置中完成。
2. 创建项目 —— 起个名字,选择本地的一个文件夹,设定 autonomy 等级
3. 开始对话 —— 在聊天框输入任务,管理 agent 自己处理
4. 走开 —— 把后续任务排进队列;每个完成项都会成为下一项的上下文
---
项目始终由同一个管理 agent 负责
管理 agent 跨会话维护项目的状态、决策与经验
管理 agent 基于同一份项目上下文把任务派给 Claude Code、Codex 或 Gemini,再记录执行结果
在每个项目的工作空间里浏览、预览、上传文件——看着 agent 的产出不断积累
把任务排进队列然后走开——agent 逐项处理,每个完成项都会成为下一项的上下文;随时可暂停介入引导,再继续
工作台(beta)——所有项目共用的一个入口:一句话交代任务,Orbital 带着该项目的上下文送到对的项目、交给对的 agent,也可以自己指定;下面是按时间排序的一份卡片,进行中的任务、待你查看的回复、agent 需要你拍板的提问,每条都标明来源项目。提问直接给出选项,点一下就答;详情按 markdown 渲染,回复框里还能附上文件
Skills——agent 从多步流程中沉淀出可复用的操作模式,下次遇到类似任务先查阅
定时与文件监听 trigger——让管理 agent 定期检查并自动派发 sub-agent,无需你动手
为每个项目设定预算上限和重置周期,实时查看按模型的花费与成本明细
网站凭据存放在系统钥匙串里,绝不暴露给聊天
手机上监督:实时查看 agent 活动,带完整上下文批准关键动作(可附加指引)
---
架构
Orbital 是绑定在一个项目上的持久管理 agent——而不是一个聊天会话。它是项目的本地 control plane,统一管理工作空间、instructions、状态、队列、预算和审批规则。管理 agent 负责规划、委派、监督并记录结果;worker agent 基于同一份项目上下文执行。你可以从任何地方监督。
mermaid
flowchart TB
UI["Frontend (React SPA)Chat UI · Approval Cards · SettinTop issues
#58[Windows] W3 deny ACE on .git\config / .git\hooks also denies SYNCHRONIZE, so the worker cannot run git at all4 comments · 2026-10-17#50[Bug/Feature] Windows 11 使用反馈:工具调用时命令行闪窗、子 Agent 退出登录失败及 pi agent 支持、模型切换保存后不生效3 comments · 2026-08-06#60[Feature] Allow per-agent environment overrides for ACP and CLI sub-agents2 comments · 2026-10-18#59[Windows] Add DSH sub-agent installation and auto-detection support2 comments · 2026-10-18#56Linux适用性问题2 comments · 2026-10-16#55Windows: sandbox setup/teardown runs icacls /T over toolchain folders, pegging CPU and stalling install and uninstall1 comments · 2026-10-09#53README demo video assets1 comments · 2026-09-06#78Decisions: make supersession explicit, and flag decisions whose grounds changed0 comments · 2026-11-14
Latest release
v0.22.0 v0.22.0 2026-11-13Orbital v0.22.0 Setting up Orbital with your own API key is now dependable from the first screen to the first task. This release also makes the app more responsive, fixes file edits that failed for no visible reason, and lets Codex run on the model you chose for it. New - A key is saved only when its connection test passes. In the setup wizard and in Settings, a key that fails its test is not stored, and you see the provider's reason in plain words. A saved key that still works is never touched, and renaming a key runs no test. - The setup wizard with a key. Next waits for a running test,