Remembra Relay
一个编码代理会话结束后,下一个代理凭 git 事实立刻接上——跨机器、跨厂商的会话交接。
- Star 数
- ★ 17
- 最近更新
- 10 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 83/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude CodeCodex(部分支持)
- 费用
- 有免费版,另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在笔记本、服务器和 worktree 之间切换同一仓库的独立开发者,希望新会话不必重新梳理上下文
- 不适合
- 不愿把会话摘要或记忆交给 Remembra 云的团队(除非自托管)
- 不使用 git 的编码工作流
- 依赖 Cursor、Gemini CLI 等未经验证 hook 的用户
- 官网
- remembra.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-11最新版本 v0.17.8(2026-11-11)
- 源码审查
- 83/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Remembra Relay 是一个 MCP 服务器加 CLI(remembra-relay),在编码代理的会话结束时生成基于 git 事实的交接简报。会话结束时,close 命令读取分支、提交、变更文件、未推送提交,以及(Claude Code/Codex)本地 transcript 中的测试结果;下一个会话开始时,brief 命令或 session_brief MCP 工具以约 1,500 tokens 交付上一次会话的完成、失败与下一步信息,并核对代理自己的摘要是否与 git 事实一致。项目通过 git remote 识别同一仓库,因此跨机器、跨 worktree 共享交接记录,所有交接按序保存在 trail 中。底层是一个可独立使用的记忆 API(Python/TypeScript SDK、REST API、21 个 MCP 工具),支持事实提取、实体解析、混合检索与 PII 防护。可用 Remembra Cloud(有免费层)或以 MIT 许可自托管(Docker + Qdrant + Ollama)。
会话结束时运行 remembra-relay close:从 git 读取分支、提交、变更/未提交文件和未推送提交;对 Claude Code 和 Codex 还解析本地 transcript 中的测试运行(transcript 不离开本机,发送前先脱敏)。下一个会话开始时运行 remembra-relay brief 或调用 session_brief MCP 工具,生成约 1,500 tokens 的简报:上一个代理是谁、哪些已完成、哪些测试失败、下一步建议——done/not done/failing 部分全部来自 git 与测试运行而非 LLM,代理自己的摘要被对照这些事实标注为未验证或被反驳。remembra-relay trail 按序查看所有交接记录。MCP 服务器(remembra-mcp)另提供 21 个工具:记忆的 store_memory/recall_memories、实体与时间线的 search_entities/timeline、代理间收件箱 send_to_inbox/get_inbox 等。底层记忆层可通过 Python SDK(from remembra import Memory; memory.store(...); memory.recall(...))或 REST API 直接使用。
- 在笔记本、服务器和 worktree 之间切换同一仓库的独立开发者,希望新会话不必重新梳理上下文
- 白天用 Claude Code、晚上换 Codex CLI 的开发者,需要跨厂商的会话交接
- 接手他人遗留工作的工程师,希望从 git 事实而不是前任代理的自我报告中了解真实进度
- 使用 Cursor、Gemini CLI 等任意 MCP 客户端的用户,通过 MCP 工具读写交接简报
- 需要给应用添加带实体解析和混合检索的持久记忆层的开发者,可直接调用 Python/TypeScript SDK
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pipx install --force 'remembra[mcp]>=0.16'curl -sSL https://raw.githubusercontent.com/remembra-ai/remembra/main/quickstart.sh | bash
- 配置文件
docker-compose.quickstart.yml- 安装说明涉及
- Docker
如何安装或部署这个 Agent?
云方式(需先在 app.remembra.dev 注册获取免费密钥):
bash
pipx install --force 'remembra[mcp]>=0.16'
remembra-install --all
remembra-relay connect --apply自托管(本地启动 Remembra + Qdrant + Ollama,无需 API 密钥):
bash
curl -sSL https://raw.githubusercontent.com/remembra-ai/remembra/main/quickstart.sh | bash或用 Docker Compose:
bash
git clone https://github.com/remembra-ai/remembra && cd remembra
docker compose -f docker-compose.quickstart.yml up -d如何使用这个 Agent?
安装后先单独运行 remembra-relay connect 预览将要写入的 hook 改动,再 connect --apply 应用(每个文件保留备份);Codex 用户需在 Codex 中运行一次 /hooks 信任 hook。之后照常使用编码代理:会话结束时 hook 自动运行 close,新会话开始时 hook 或 session_brief MCP 工具自动提供简报。手动查看交接记录:
bash
remembra-relay trail验证安装:
bash
remembra-doctor all直接使用记忆 API:
python
from remembra import Memorymemory = Memory(user_id="user_123")
memory.store("Had a meeting with Sarah from Acme Corp. She prefers email over Slack.")
result = memory.recall("How should I contact Sarah?")
print(result.context)这个 Agent 有哪些优点和局限?
- 交接事实来自 git 和测试运行而非 LLM,代理的自我陈述会被对照核实,README 给出了摘要与 git 不符时被反驳的具体示例
- 通过 git remote 识别项目,交接跨机器、跨 worktree、跨厂商(Claude Code、Codex 与任意 MCP 客户端)
- 可完全自托管(MIT,Docker + Qdrant + Ollama),自托管免费
- 附带完整的记忆层:21 个 MCP 工具、Python/TypeScript SDK、实体解析、时间线查询和代理间收件箱
- 核心交接依赖 Remembra 云服务(免费层存在,但需要注册密钥),完整离线需自行部署服务器
- 仅 Claude Code 和 Codex 的会话 hook 经过验证;Cursor、Gemini CLI、Qwen Code、Kimi 的 hook 未经验证,需要 --include-unverified 才会安装
- Codex 支持依赖预发布版 codex-cli 0.155.0-alpha.16.4,尚无稳定版 Codex 被测试
- 基准证据薄弱:仅运行了 1/10 个 LoCoMo 对话(76%,对抗性问题全部 0 分),全量运行尚未完成
这个 Agent 与同类方案有什么区别?
README 将其与三类替代方案对比(docs/comparisons/handoff-tools.md 附来源与日期):厂商内置记忆(Claude Code、Codex、Copilot、Windsurf)不能跨厂商且无持久交接轨迹;本地交接工具(如 claude-mem、agentmemory)不能跨机器、依赖 transcript/diff;记忆 API(Mem0、Zep、Letta)可跨机器但交接事实不来自 git。Relay 的差异化是跨厂商 + git 事实核查 + 持久 trail。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Remembra Relay 当前 | 83 · 表现良好 | Agent 插件 / 技能免费版 + 付费版 | ★ 17 | 10 天前 | Python | Claude Code |
| Happier | 62 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 2.2k | 今天 | TypeScript | Codex · Claude Code |
| Emulo | 76 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 306 | 1 个月前 | HTML | Codex · Claude Code |
| DevSpace | 64 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 5.5k | 19 天前 | TypeScript | ChatGPT |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
CLI 安装器会先显示变更并询问后再写入,Relay 连接可先预览,文件变更保留备份;密钥通过隐藏提示或环境变量读取,文档说明转录保留在本机、发送内容中的已识别密钥会脱敏,并明确 SQLite 中的记忆文本仍为明文。安全措施较完整,但脱敏依赖模式匹配,且加密只覆盖有限字段;CLI 与 MCP 的写入权限和确认边界也未在所给材料中完整展示,因此未满分。来源归属只由包作者/维护者字段和安全联系地址部分支持,发布者身份仍未验证。
Relay CLI 文档说明了时间预算、超时回退、失败入队和重试;doctor 提供只读诊断与针对问题的修复建议。其与 README、配置和安装指南在主要用法上基本一致,但材料出现版本差异(包元数据为 0.17.6,文档示例多为 0.16.x),且若干支持状态按特定客户端版本限定,故自洽性和依赖可用性为 2。
材料清楚面向跨编码代理的会话交接与协作,描述 MCP 工具和各客户端支持状态;区分 git/转录收集事实、代理自行声明的未验证事实,以及尚未验证的 Cursor 等边界。钩子、MCP、CLI、自托管和多种客户端配置覆盖不同运行环境,并明确适用场景和限制,支持满分。
README、安装、配置、安全、故障排除和 Relay 用法分区清楚;安装、诊断、示例、常见问题式排障、限制和 MIT 许可证说明充分。命名与版本记录有支持,但所给包版本、安装下限和示例版本不完全一致,且本材料未包含完整变更日志内容,故相关项目未满分。维护者字段和漏洞报告通道明确,但维护责任与更新承诺仅部分清楚,发布者身份未知。
Relay 将 git 与部分客户端转录中的会话事实整理成短交接摘要、待办和轨迹,并标出代理摘要与事实冲突及未验证声明,产出可直接供下一代理使用。跨机器、跨厂商的延续性有明确用途;但价值依赖远端 Remembra 服务、密钥、钩子安装和不同客户端支持状态,额外设置成本存在。
README 对核心工作流、事实来源和验证状态作出具体说明,CLI 源码文档字符串补充预算、队列、钩子和项目解析行为;安全、配置、安装文件提供部分互证。大量产品行为在给定源码摘录中没有对应实现正文,且 CI 配置仅展示部分,因此交叉来源 corroboration 为部分而非完整。材料明确区分事实、推断、声明与未验证状态,支持满分。
- 发布者身份未验证;不要将作者/维护者元数据当作已核实的组织身份。
- 会话交接可能包含敏感上下文;密钥脱敏基于已知模式,且安全文档明确说明 SQLite 中的记忆文本与部分索引不受字段加密保护。
- 安装会写入代理配置与钩子。先审阅预览;不同代理的钩子验证状态和受支持版本不同。
- 版本信息需核对:包元数据标为 0.17.6,而所给安装命令及安全发布示例多使用 0.16.x。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * Release 0.17.8: restore recovery, queued waits and hook diagnostics by @Mani87-nq in https://github.com/remembra-ai/remembra/pull/91 Full Changelog: https://github.com/remembra-ai/remembra/compare/v0.17.7...v0.17.8在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * 0.17.7: fixes from the Codex/Claude fault survey (49 faults, frozen paths untouched) by @Mani87-nq in https://github.com/remembra-ai/remembra/pull/90 Full Changelog: https://github.com/remembra-ai/remembra/compare/v0.17.6...v0.17.7在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/remembra-ai/remembra/compare/v0.17.5...v0.17.6在 GitHub 查看 ↗
常见问题
必须付费吗?
我的代码和 transcript 会离开本机吗?
我用 Cursor 或 Gemini CLI,能用吗?
交接简报里多少内容是 LLM 生成的?
多个代理同时在同一仓库工作会冲突吗?
Remembra Relay 官网是什么?
Remembra Relay 开源吗?
Remembra Relay 安全吗?
Remembra Relay 还在维护吗?
Remembra Relay 是谁开发的?
谢谢反馈,我们会据此改进页面。