timwongup/agentnave

** 从代理管理器到CLI子代理之间的薄本地桥。**

AgentNave 允许代理管理器启动 Antigravity CLI、Claude Code、CodeBuddy Code、Codex CLI， Grok CLI、Pi 编码代理或 DeepSeek Harness 作为子代理，一次一个或作为一组并行响应，或 串行回合。每个提供者保留其原生认证， 配置、权限和会话模型;AgentNave 提供适配器和进程 对此进行监督。

边界是有意为之。AgentNave 不规划任务、不分配角色、不构建 DAG 或选择 并行处理、查看结果、综合答案、重试工作或管理工作树。这些决策 属于呼叫代理管理器，完整的任务上下文已存在。

AgentNave 没有面向真人的用户 CLI。agentnave-mcp 命令仅是 STDIO 的入口点 一个兼容的MCP主机。

在托盘应用中，头像→设置允许你上传自定义图片或恢复官方图片 模型图标。覆盖可以针对模型族或特定的CLI/模型对。 它们保持在本地数据目录的 avatars.json 中，并由聊天、托盘和浏览器视图共享。

简体中文 · English

AgentNave 是一个本地 MCP 服务。 你正在用的 Agent（Claude Code、Codex……）当老板，把活派给本机装好的其他 CLI：可以单独派一位，也可以拉几位一起，并联各答各的，或者串联轮流发言。另有一个托盘「小办公室」App： 谁在工位上干活、谁去了会议室、大家说了什么，都能看到。

🎬 实机演示

✨ 能做什么

• 🧑‍💼 派一位组员干活：start_agent 把任务交给一个 CLI，结果只回给老板
• 👯 拉几位组员开个会：run_round 请 2–7 位组员进会议室。默认开两轮并联：第一轮各自给方案，第二轮看过大家的回答再补充，最后由 boss 总结。想让大家最后接力收个尾，就加一轮串联，后发言的人能看到前面的回答
• 🔍 先审再公开：开了审核，每条回答由老板决定公开还是留作私聊，不公开的回答其他席位看不到
• 🏢 托盘小办公室：工位、会议室、对话记录一目了然，旧工作区可以一键清理
• 🧠 原生会话照旧：每个 CLI 用自己的登录、配置和原生会话，保留 session_id，之后能接着聊
• 🤝 换个聊天接着干：对老板说「转交这个会话」，到新聊天说「接手」；额度用完写不了交接文档，也能让新老板接手那个宿主的会话

👀 谁当老板，谁当组员

老板的范围更大：上面这些宿主都能当老板，桌面端也可以；组员目前只有表里这几个 CLI。宿主不会用 start_agent 把单个任务派给自己的 CLI，但会议里可以有它的席位。

🎀 组员图鉴

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

🚀 快速开始

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

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

1. 到 Releases 下载 AgentNave__universal.dmg，拖进「应用程序」。

2. 打开 App，按「开始使用」走完四步：安装本机服务 → 接入一个宿主 → 设置组员 → 在宿主里派一次任务。 接入宿主时，App 会顺便装好配套的 agentnave-manager 和 agentnave-handover Skill。

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