开源 Handoff:给多个编码 Agent 一个共享项目记忆的 MCP 服务器
Rude_Schedule9614 · reddit · 2026-10-11
作者在多个 Agent(Claude Code、Copilot、Gemini CLI、Codex)共用同一仓库时,发现每个新会话都从零开始,于是开发了 Handoff——一个本地 stdio MCP 服务器加 CLI,为每个项目维护一份共享、只追加的记忆:Agent 读取最新 handoff(技术栈、当前状态、下一步动作),结束时留下自己的。
核心设计要点
- 只提供三个窄工具:memoryget(只读)、memorysave(追加式,摘要占位或缺 next actions 会返回警告让 Agent 自我修正)、memoryhistory,无 SQL、无删除、无自由键
- 用 projectpath 显式参数替代 roots,按最近的 .git 和规范化的 origin remote 键控,记忆跟随仓库跨移动与克隆
- 依赖 server instructions 引导调用时机,并为支持的客户端安装生命周期钩子:会话开始注入最新 handoff,git 工作区有变更时在结束前提醒调用 memorysave(同一状态不重复提醒)
- handoff setup 可为 14 种客户端写配置,预览+备份+原子写入,从不自动设置 autoApprove/信任白名单
- 安全:仅本地、无网络端口,存储前按模式掩码常见密钥格式(因为记忆会被其他厂商的模型读取)
技术栈 Python 3.10+、官方 MCP SDK、SQLite,MIT 协议,pipx install ai-handoff 安装。作者还就「如何让 Agent 可靠调用保存工具」「哪些客户端会传递 server instructions」征询社区意见。
「编程与Agent」频道最新
- 本地沙箱仍是空白机会:开发者花数十小时调通远程 Agent — zeeg · 2026-10-12
- Matt Shumer 发布 Workbench:一份 Markdown 文档指挥多个 agent 协作 — mattshumer_ · 2026-10-12
- Agent 工程师最易踩坑:缓存超时让你默默烧掉预算 — brandon_galang · 2026-10-12
- 审 agent 写的 PR 怎么查?故意弄坏代码看测试挂不挂 — ITower__Education · 2026-10-12
- Matt Pocock 用 Opus 搭 chief-of-staff skill,验证环节疯狂到离谱 — mattpocockuk · 2026-10-12
- 用户弃订 ChatGPT Pro 200 美元套餐,转投 Opus 编码 — karmay007 · 2026-10-12