Remembra Relay

一个编码代理会话结束后,下一个代理凭 git 事实立刻接上——跨机器、跨厂商的会话交接。

Star 数
★ 17
最近更新
10 天前
License
MIT
主语言
Python

30 秒速览

运行形态
Agent 插件 / 技能MCP 服务器代码库 / SDK
可在哪里用
通用 · 跨平台Claude CodeCodex(部分支持)
费用
有免费版,另有付费云服务
上手难度
低 · 几分钟可跑通
开始前需要
Python / pipxRemembra API 密钥(云)或自托管服务器Docker(自托管用,含 Qdrant + Ollama)Shell / 命令行网络访问本地文件系统
典型场景
在笔记本、服务器和 worktree 之间切换同一仓库的独立开发者,希望新会话不必重新梳理上下文
不适合
  • 不愿把会话摘要或记忆交给 Remembra 云的团队(除非自托管)
  • 不使用 git 的编码工作流
  • 依赖 Cursor、Gemini CLI 等未经验证 hook 的用户
官网
remembra.dev ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-11最新版本 v0.17.8(2026-11-11)

这个 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 直接使用。

  1. 在笔记本、服务器和 worktree 之间切换同一仓库的独立开发者,希望新会话不必重新梳理上下文
  2. 白天用 Claude Code、晚上换 Codex CLI 的开发者,需要跨厂商的会话交接
  3. 接手他人遗留工作的工程师,希望从 git 事实而不是前任代理的自我报告中了解真实进度
  4. 使用 Cursor、Gemini CLI 等任意 MCP 客户端的用户,通过 MCP 工具读写交接简报
  5. 需要给应用添加带实体解析和混合检索的持久记忆层的开发者,可直接调用 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 Memory
memory = 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?

FollowAgents 源码审查 · FARS-2.1
表现良好
83/ 100 五分制 4.2 / 5
本评测基于 2026年11月8日 的源码;此后该项目发布了 3 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 19/29
可靠稳定 11/14
适用触发 18/18
规范维护 16/18
有效结果 12/13
证据核验 7/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

CLI 安装器会先显示变更并询问后再写入,Relay 连接可先预览,文件变更保留备份;密钥通过隐藏提示或环境变量读取,文档说明转录保留在本机、发送内容中的已识别密钥会脱敏,并明确 SQLite 中的记忆文本仍为明文。安全措施较完整,但脱敏依赖模式匹配,且加密只覆盖有限字段;CLI 与 MCP 的写入权限和确认边界也未在所给材料中完整展示,因此未满分。来源归属只由包作者/维护者字段和安全联系地址部分支持,发布者身份仍未验证。

可靠稳定11 / 14 · 3.9/5

Relay CLI 文档说明了时间预算、超时回退、失败入队和重试;doctor 提供只读诊断与针对问题的修复建议。其与 README、配置和安装指南在主要用法上基本一致,但材料出现版本差异(包元数据为 0.17.6,文档示例多为 0.16.x),且若干支持状态按特定客户端版本限定,故自洽性和依赖可用性为 2。

适用触发18 / 18 · 5.0/5

材料清楚面向跨编码代理的会话交接与协作,描述 MCP 工具和各客户端支持状态;区分 git/转录收集事实、代理自行声明的未验证事实,以及尚未验证的 Cursor 等边界。钩子、MCP、CLI、自托管和多种客户端配置覆盖不同运行环境,并明确适用场景和限制,支持满分。

规范维护16 / 18 · 4.4/5

README、安装、配置、安全、故障排除和 Relay 用法分区清楚;安装、诊断、示例、常见问题式排障、限制和 MIT 许可证说明充分。命名与版本记录有支持,但所给包版本、安装下限和示例版本不完全一致,且本材料未包含完整变更日志内容,故相关项目未满分。维护者字段和漏洞报告通道明确,但维护责任与更新承诺仅部分清楚,发布者身份未知。

有效结果12 / 13 · 4.6/5

Relay 将 git 与部分客户端转录中的会话事实整理成短交接摘要、待办和轨迹,并标出代理摘要与事实冲突及未验证声明,产出可直接供下一代理使用。跨机器、跨厂商的延续性有明确用途;但价值依赖远端 Remembra 服务、密钥、钩子安装和不同客户端支持状态,额外设置成本存在。

证据核验7 / 8 · 4.4/5

README 对核心工作流、事实来源和验证状态作出具体说明,CLI 源码文档字符串补充预算、队列、钩子和项目解析行为;安全、配置、安装文件提供部分互证。大量产品行为在给定源码摘录中没有对应实现正文,且 CI 配置仅展示部分,因此交叉来源 corroboration 为部分而非完整。材料明确区分事实、推断、声明与未验证状态,支持满分。

风险与缓解建议
  • 发布者身份未验证;不要将作者/维护者元数据当作已核实的组织身份。
  • 会话交接可能包含敏感上下文;密钥脱敏基于已知模式,且安全文档明确说明 SQLite 中的记忆文本与部分索引不受字段加密保护。
  • 安装会写入代理配置与钩子。先审阅预览;不同代理的钩子验证状态和受支持版本不同。
  • 版本信息需核对:包元数据标为 0.17.6,而所给安装命令及安全发布示例多使用 0.16.x。
证据充分度:低 评估于 2026年11月8日 审查版本 8c7d0200c27e 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/remembra.svg?lang=zh)](https://followagents.com/zh/agents/remembra)
<a href="https://followagents.com/zh/agents/remembra"><img src="https://followagents.com/badge/remembra.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.17.8
    发布说明摘录
    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 查看 ↗
  2. v0.17.7
    发布说明摘录
    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 查看 ↗
  3. v0.17.6
    发布说明摘录
    Full Changelog: https://github.com/remembra-ai/remembra/compare/v0.17.5...v0.17.6
    在 GitHub 查看 ↗

常见问题

必须付费吗?
交接、简报、收件箱、trail 和搜索在所有计划免费。Remembra Cloud 付费层为 Solo $12/月、Pro $29/月、Team $15/席位/月;自托管在 MIT 许可下完全免费。
我的代码和 transcript 会离开本机吗?
transcript 本身不离开本机,发送前会脱敏并只收集交接所需的事实;若不希望任何数据经过 Remembra 云,可自托管服务器并在 remembra-install 时加 --url 指向自己的服务器。
我用 Cursor 或 Gemini CLI,能用吗?
可以通过 MCP 工具(session_brief、close_session)读写交接,但其会话 hook 属于 unverified,需要 connect --include-unverified 才会安装。
交接简报里多少内容是 LLM 生成的?
done、not done、failing 部分全部来自 git 与会话中的测试运行;代理自己的摘要仅作对照展示,且被标注为未验证或被反驳。
多个代理同时在同一仓库工作会冲突吗?
每个代理可用各自的 scoped key,交接记录会显示为 key-verified;同一仓库(按 git remote 识别)在所有机器上被视为一个项目,交接按序保存在 trail 中。
Remembra Relay 官网是什么?
Remembra Relay 的 GitHub 仓库填写的官网是 https://remembra.dev。这个链接由仓库作者设置;源码在 GitHub(remembra-ai/remembra)。
Remembra Relay 开源吗?
开源。源码在 GitHub(remembra-ai/remembra),许可证是 MIT。
Remembra Relay 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 Remembra Relay 的“信任与安全”打了 19/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Remembra Relay 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-11,在最近 30 天内。最新版本是 v0.17.8(2026-11-11)。
Remembra Relay 是谁开发的?
Remembra Relay 由 GitHub 账号 remembra-ai 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念