简体中文 · English

AgentNave 是一个本地 MCP 服务。 让你正在用的 Agent（Claude Code、Codex……）当 boss，把活派给本机装好的其他 CLI。配套的托盘 App 是一间小办公室：谁在干活、谁在开会、大家说了什么，都看得见，也听得到。

🎬 实机演示

✨ 几大特点

🧑‍💼 一个 boss，一屋子 CLI

12 种宿主能当 boss，8 种 CLI 能当员工，派活用的是同一套工具。每个 CLI 继续用自己的登录和配置，聊过的会话之后还能接着聊。

👯 私聊和会议

可以单独派一位员工，结果只回给 boss；也可以请 2–7 位员工开会：默认两轮并联，第一轮各自给方案，第二轮看过大家的回答再补充，最后由 boss 总结；想接力收尾就加一轮串联。开了审核，每条回答由 boss 决定公开还是留作私聊，不公开的回答其他席位看不到。

🏢 看得见的小办公室

工位、会议室和完整对话一目了然，菜单栏随时能看谁在干活。小人按模型家族出场，也可以上传自己的一套。宿主异常退出后，失联的任务会显示为已中断，不会一直挂着运行中。

🎧 听得到的办公室

点一下「收听」，App 就把会议、私聊或整个工作区读给你听，默认听 1 小时，到时自动停。每场会议或私聊是一张专辑，点说话人能跳到正在读的消息。语音用你自己的 ElevenLabs 或 MiniMax 密钥，发言文本会发给所选的云端引擎。

🙋 弹框由 boss 代答

在 macOS 和 Linux 上，Claude 默认以交互模式运行，省订阅额度。运行中的权限框、提问框和计划确认交给 boss 回答，不用你守着。其他 CLI 默认用自带的自动审批，也可以在 App 里改成完全放开。

🧭 工位和评审

在 App 里给 Explorer、Worker 工位选好模型，简单、困难和界面任务各有档位，boss 按任务难度派活。可选的生图工位只需选 CLI 和对话模型，由它调用自身的生图服务。还可以加一道合并前评审：按风险大小决定派谁来看，评审的员工只读不改，结论留作记录。

🤝 换个聊天接着干

对 boss 说「转交这个会话」，到新聊天说「接手」。额度用完写不了交接文档时，也能让新 boss 接手那个宿主的会话。

🧹 App 替你管杂事

接入宿主时顺便装好 Skill，员工要确认后才能派发。CLI 有新版本时一键更新，没装的给出官方安装命令。App 和本机服务在 App 里更新，旧工作区一键清理，历史按你设的天数自动清理。

👀 谁当 boss，谁当员工

角色	支持
boss（接入 AgentNave、负责派活）	Claude 桌面端、Claude Code、Codex CLI、CodeBuddy Code、WorkBuddy 桌面端、Grok CLI、Antigravity、Pi、DeepSeek Harness、ZCode、Hermes、Grok Bot（仅 Linux）
员工（被派活的 CLI）	Claude Code、Codex CLI、CodeBuddy Code、Grok CLI、Antigravity CLI、Pi Coding Agent、DeepSeek Harness、ZCode

宿主不会把单个任务派给自己的 CLI，但会议里可以有它的席位。

Grok Bot 只能在 Linux 上接入，不支持 macOS 和 Windows App，也看不到它的模型和会话记录，详见无头 Linux 宿主指引。

🎀 员工图鉴

小人按模型家族分配，不看用的是哪个 CLI：用 Codex CLI 跑 GPT，出场的就是 GPT 那位小龙娘。没有专属形象的模型由「新同事」代班。 想换成自己的小人，在 App 设置的「外观」页上传一套就行。

🚀 快速开始

先准备好 uv、Git，以及至少一个已经登录的 CLI。AgentNave 不帮你安装或登录 CLI。

方式一：托盘 App（macOS、Windows，推荐）

1. 到 Releases 下载安装包：macOS 用 AgentNave_<版本>_universal.dmg，拖进「应用程序」；Windows 用 AgentNave_<版本>_x64-setup.exe。

2. 打开 App，在设置的「boss」页接入一个宿主，按需在「员工」页确认其他 CLI。本机服务和配套 Skill 由 App 自动安装。

3. 回到宿主里说一句试试：

   用 agentnave 让两位员工各自回答一遍：这个仓库是做什么的？
   

方式二：手动安装（Linux，或不装 App）

当前配套版本是 v1.3.0，运行时和 Skill 都要从这个 tag 安装：

uv tool install --python 3.12 "git+https://github.com/TimWongUp/agentnave.git@v1.3.0"

然后按安装指南注册 MCP、安装 agentnave-manager 和 agentnave-handover Skill，再做验证。 安装指南本来就是写给 Agent 看的，可以直接交给你的 Agent，让它照着检查和安装。 无头 Linux（没有 App）：比如 Grok Bot 这类跑在 Linux 上、只能以 MCP 连接器接入的 bot，按 Linux 装完后的设置指引 一步步带用户完成设置，配置文件的细节见 无头 Linux 宿主接入指引。

任务和会议的历史保存在 ~/.agentnave/（也可以用 AGENTNAVE_DATA_DIR 指定别的目录）。各 CLI 的登录、配置和原生会话仍归 CLI 自己管。

🧭 分工：AgentNave 管什么

AgentNave 只负责把活派出去、管好进程、把结果原样带回来。怎么拆任务、找谁、要不要复核，都由 boss 来定，因为完整的上下文在 boss 手里。

AgentNave	boss
启动和停止各家 CLI	规划和拆分任务
盯着任务跑完，不留残余进程	选谁来做、用什么模型
把结果原样带回来	同时派几位、要不要复核
保存任务和会议记录	失败了要不要重试
主持会议的轮次	谁来答、按什么顺序、答得行不行

AgentNave 默认让派出去的 CLI 用自带的自动审批；CLI 没有自动审批时就直接放开。Claude 以交互模式运行时，仍要确认的弹框由 boss 代答。在 App 里也可以把某个 CLI 改成完全放开。 AgentNave 没有给人用的命令行，你只需要跟 boss 说话。

🔒 任务的去留与安全

宿主关闭时，AgentNave 会停掉还在跑的员工，已保存的记录还在，保存的会议和聊过的会话之后都能继续。

AgentNave 不是沙箱。 它只负责管好进程，员工能做什么取决于各 CLI 自己的权限设置。需要严格隔离时，请用操作系统级别的隔离。

🛠️ 开发与验证

下面的检查用于开发用的 checkout，不适用于上面的 uv tool 安装。完整流程见 CONTRIBUTING.md。

uv sync --locked --all-groups
uv run ruff format --check .
uv run ruff check .
uv run pyright
uv run pytest

🤝 参与贡献

欢迎通过 GitHub Issue 和 Pull Request 参与，开发流程和验证要求见 CONTRIBUTING.md。 安全漏洞请不要发公开 Issue，按 SECURITY.md 走仓库的私密报告渠道。

🙏 致谢

托盘查看会话的思路，以及读取 Claude、Codex 会话记录判断 boss 所在应用的做法，参考了 magpie。CLI 图标来自 LobeHub Icons（MIT）。

📄 许可证

AgentNave 以 MIT 许可证发布。