MemoSync
与编码 Agent 共同管理跨会话记忆,随时看清它学到了什么、用了什么、有没有照做。
- Star 数
- ★ 396
- 最近更新
- 6 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 已经使用 Claude Code 或 Codex 的开发者,发现自己看不懂 CLAUDE.md 里到底攒了什么、Agent 这轮又用了哪几条。
- 不适合
- 希望全自动、不愿逐轮审核记忆的用户
- 需要 Windows 或 Intel Mac 原生桌面版的团队
- 要求不把对话发给模型提供商的团队
- 官网
- memosync.cc ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-15最新版本 v0.45.0(2026-11-14)近 7 天每天 +14.7 ★
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
MemoSync 是一个本地记忆工作台,把 Claude Code、Codex、Pi 和 OpenCode 已有的记忆(如 CLAUDE.md、笔记、历史经验)放到界面上,让你和 Agent 共同维护。记忆以短条目为单位,每条带 personal、project、session 作用域、版本和历史;一轮对话中,同一批条目会依次经过提议审核、工作记忆选择、回复内引用、事后审计四个环节。它提供 React 前端和 Bun 服务端,默认在 http://localhost:3210 打开,也可以打包成 macOS 桌面应用。全部数据存放在本机 ~/.memosync/data/ 下的 SQLite 与 Markdown 副本中,MemoSync 本身不上传任何内容,但所选记忆与对话仍会发给模型提供商。
一轮对话开始前,MemoSync 从上一轮交流与 Agent 的实际动作(文件、命令、错误)中提取新记忆候选,列出跨项目迁移的规则(原文、泛化改写、本项目适配三版并列)以及对已有条目的冲突、重复与失效修正,全部等你接受、编辑、改写作用域或驳回后才写入存储。随后「Working Memory for This Turn」列出本轮打算使用的条目及一行用途说明,你可以删行、从库中补行,或用自然语言下指令(如「drop the commit-style ones」),确认后 Agent 才开始。执行过程中,回复会以 M-07 形式标注引用的记忆,工具调用折叠成「Read 3 files, ran 2 commands」样式;若 Agent 违反某条记忆,可按 Stop 停下、写下正确做法,并可选在本轮强制该条目,Agent 会从被打断的句子继续。回合结束后,一个独立审计环节读完整段对话,把每条被选中的记忆评为 violated、shaped、not applicable 或 no visible effect,并标明结论来自审计还是 Agent 自述;被违反的条目可跳转到对应句子与工具调用,或设为下轮强制项。回合之间,Memory Board 以图谱或按作用域分栏的看板展示整个库,可拖拽改作用域、查看历史、归档;Memory files 保留 Markdown 副本并可导入现有 CLAUDE.md,Import memory 可把 Claude Code 与 Codex 已有记忆拆成条目供审核。Memory Record 记录每轮的提议、选择、引用、中断与审计结果,能跨越上下文压缩保留。
- 已经使用 Claude Code 或 Codex 的开发者,发现自己看不懂 CLAUDE.md 里到底攒了什么、Agent 这轮又用了哪几条。
- 团队需要每次改记忆都经过人工确认,避免 Agent 自行写坏项目规则。
- 在多个项目之间工作的人,想把某个项目里的通用规则迁移到另一个项目,并逐版对比改写结果。
- 做上下文工程研究或调参的人,想量化某条记忆对具体回合是起作用、无效还是被违反。
- 希望记忆和聊天记录只留在本机、不进入第三方云端的个人开发者。
- 需要在一轮任务跑到一半时叫停 Agent 的错误行为,并把纠正沉淀回记忆条目的使用者。
如何安装或部署这个 Agent?
macOS(Apple silicon)用户从 Releases 下载 DMG,拖入「应用程序」即可。首次打开会被系统拦截,需先在「系统设置 → 隐私与安全性」里选择「仍要打开」。应用本身不含 Agent,请先安装 Claude Code 或 Codex;使用 Pi 需先装 @earendil-works/pi-coding-agent 1.3.0 或更新版本。
从源码安装需要 Bun 1.3.5 或更新版本,以及已登录的 Claude Code / Codex 或任意提供商的 API 密钥:
git clone https://github.com/SLEEPYBQ/MemoSync.git
cd MemoSync
bun install
bun run build
bun run start桌面版开发与打包(仅 macOS,按本机架构):
bun run desktop:install
bun run desktop:dev
bun run desktop:package:mac如何使用这个 Agent?
先打开 Settings → Models 选择引擎(Claude Code、Codex、Pi 或 OpenCode)并配置访问方式:可以直接沿用你已有的登录,也可以点 Add connection 选择内置提供商或填写 Custom endpoint,用 Test 发一个小请求验证后再选默认模型。
然后在侧边栏点 + → Add project 打开一个文件夹并发送任务。空库的前几轮大多是记忆提议,逐条审核即可积累。需要在别的端口或对外提供服务时:
bun run start --port 4000
bun run start --no-open
bun run start --remote
bun run start --password <pw>记忆行为在 Settings → Memory 中调节:Use Memory 全局关闭记忆,Learn From Chats 停止提议新条目,Control 在 Review each turn 与 Automatic 之间切换,Memory Changes 决定新提议是先审还是自动应用。数据导出与开发命令:
bun run export-data
bun run export-data --full
bun run dev
bun test src/这个 Agent 有哪些优点和局限?
- 把记忆拆成带作用域、版本和历史的小条目,写入前必须人工确认,避免了 CLAUDE.md 无限膨胀、内容不可审计的问题。
- 审计环节独立于 Agent 自述,能标出 Agent 从未引用却确实违反的记忆,并提供跳转到具体句子和工具调用。
- 支持 Claude Code、Codex、Pi、OpenCode 四种引擎,且非 Anthropic/OpenAI 协议的连接可通过 127.0.0.1 本地网关翻译,引擎拿不到你的密钥。
- 数据全部落在 ~/.memosync/data/,API 密钥存于仅本机可读的 credentials.json,并提供 --password、--remote、--share 等自托管选项。
- 具备 Automatic 模式与逐条 Revert,兼顾需要严格审核和只想快速提问两种场景。
- 官方 DMG 仅面向 Apple silicon Mac 且尚未公证,首次启动需手动绕过系统拦截。
- 必须依赖外部编码 Agent:Codex 需本机已安装,Pi 需特定版本包,OpenCode 需 1.17.4 以上,版本过旧只能用引擎卡上的 Upgrade 按钮补救。
- 审计结论本质是模型判断,README 明确说明可能出错,不能当作合规证据。
- 应用与源码安装共享 ~/.memosync/data,二者不能同时运行,切换方式时需要注意。
- 对话、所选记忆与项目上下文仍会发送给模型提供商,并非完全离线的记忆方案。
这个 Agent 与同类方案有什么区别?
与直接依赖 CLAUDE.md 等静态记忆文件的编码 Agent 相比,MemoSync 把记忆做成可版本化、可审核、可审计的条目,并额外提供违反检测与回合内叫停;代价是引入了独立的本地服务与逐轮确认的流程。README 提到它最初 fork 自 Kanna,可作为了解其来源的参照。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| MemoSync 当前 | 50 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 396 | 6 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| Emulo | 76 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 306 | 1 个月前 | HTML | Codex · Claude Code |
| Solo Agent | 55 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 605 | 2 个月前 | Go | Codex · Claude Code |
| PRO-LONG | 60 · 存在缺口 | 命令行工具免费 | ★ 465 | 18 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 明确说明 agent 与终端以当前用户身份运行、可访问文件系统,profile 隔离只隔离配置不隔离文件系统,属于诚实披露但权限面很大,least_privilege 仅 1;用户确认机制(每轮审阅、Ask First、敏感项必须确认、Stop 引用)在文档与代码中一致,给 2;数据流透明(本地 ~/.memosync/data、不上传、provider 会收到对话与记忆、导入只读)描述清楚,给 2;敏感数据处理有 looksLikeSecret 与敏感项不写入 Markdown 投影的实现,给 2;依赖数量庞大且含 beta 版本(@legendapp/list beta、cloudflared、多个 SDK),未见审计或锁定策略说明,dependency_security 仅 1;external_effects 有 --remote/--share/cloudflared 等对外暴露能力,仅文档提示,未见默认安全约束,给 1;回滚有 Revert、归档、Removed 恢复、SQLite 为权威源,给 2;来源归属在 LICENSE 与 Acknowledgements 中标注 Kanna 派生及第三方许可,给 2。
代码注释与 README 对 SQLite 权威、Markdown 投影为导出、崩溃后重建的描述自洽,给 2;依赖可用性依赖外部 CLI(claude/codex/opencode/pi)与版本门槛,README 有说明但未提供降级或校验机制,给 1;失败信息方面仅见 console.warn 与少量 throw,用户可见错误处理证据薄弱,给 1。
面向 Claude Code/Codex/Pi/OpenCode 多引擎与多场景(审阅/自动)覆盖较好,给 2;能力边界(不内置 agent、仅 macOS 桌面、Windows 不支持、审计可能出错)有说明,给 2;trigger_precision 方面记忆注入默认 all-in、依赖模型判断引用与审计,触发条件较模糊,给 1;environment_fit 仅 macOS 打包、Linux 源码运行,Intel Mac 需源码,给 1。
README 结构清晰、分节完整,给 2;安装说明含 DMG、源码、Bun 版本、未公证提示,给 2;naming_stability 存在 Kanna 遗留命名(KANNA_RUN_LIVE_TITLE_TESTS、ci 注释中的 Kanna 测试),给 1;示例以截图与视频为主,缺少文字 FAQ 与故障排查,给 1;known_limitations 有零散说明(未公证、审计可能错、单实例)但未集中成节,给 1;LICENSE 为完整 MIT 并保留上游版权,给 2;versioning_changelog 仅有 package.json 版本号,无 CHANGELOG,给 1;maintenance_responsibility 发布者未经验证、无维护者与支持渠道说明,给 1。
输出可用性上提供审阅卡、引用、审计结论与 Memory Board,界面与数据模型具体,给 2;边际价值在于把隐式记忆显式化并可审计,相对原生 agent 有增量,给 2;成本收益上每轮审阅开销大、依赖外部模型做审计与精炼、需自备 API key 或登录,给 1。
claim_traceability 有引用与审计定位到句子与工具调用,但引用被明确说明不等于证明,给 1;cross_source_corroboration 仅 README、AGENTS.md、少量源码与 CI 相互印证,样本有限,给 1;fact_inference_separation 较好,README 明确区分 agent 自报与审计发现、审计可能出错,给 2。
- agent 与终端以当前用户身份运行并可访问文件系统,profile 隔离不隔离文件系统;在不受信任的项目中使用前应评估权限面。
- --remote、--share 与 cloudflared 可将本地服务暴露到 LAN 或公网,默认应避免开启,开启时务必配合 --password。
- 依赖数量大且含 beta 版本与外部 CLI 版本门槛,未提供依赖审计或锁定策略说明。
- 记忆注入默认 all-in,引用与审计依赖模型判断,README 自承审计可能出错,不应将其视为合规证明。
- 发布者身份未经验证,且代码中残留 Kanna 命名与测试配置,维护责任与更新路径不明确。
- macOS 应用未公证,首次打开需手动绕过 Gatekeeper,应确认下载来源。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.45.0 MemoSync v0.45.0
发布说明摘录
MemoSync v0.45.0 brings the desktop app to Windows, Linux and Intel Macs, alongside Apple silicon. Desktop platforms - Windows x64: a per-user installer and a ZIP containing MemoSync.exe. - Linux x64: an AppImage and a Debian/Ubuntu .deb package. - macOS: separate DMG and ZIP downloads for Apple silicon (arm64) and Intel (x64). …在 GitHub 查看 ↗ -
v0.44.0 MemoSync v0.44.0
发布说明摘录
MemoSync v0.44.0 adds controls for the full memory lifecycle: retire rules, correct audits, set expiry dates, detect file changes, and share project rules through Git. What's new - Archive from where you work. Retire or restore a memory from Working Memory, citation cards, audit rows, or the Memory Board. “Open in Board” opens the cited memory without leaving your chat or losing its draft. …在 GitHub 查看 ↗ -
v0.43.1 MemoSync v0.43.1
发布说明摘录
MemoSync v0.43.1 fixes Codex chats after a permission change and two composer glitches. Fixes - Codex after a permission change. In a new Codex chat, switching the mode (for example to Full access) before the first message made every send fail with no rollout found for thread id …. MemoSync now starts a fresh Codex thread in that case; the old one had never run a turn, so nothing is lost. Chats stuck this way recover on their next message. …在 GitHub 查看 ↗
常见问题
MemoSync 自己会调用模型吗?费用怎么算?
它能读取我现有的 CLAUDE.md 和 Codex 记忆吗?会不会改动它们?
审计判定不可靠怎么办?
我的数据和密钥存在哪里?
可以放在局域网或远程机器上访问吗?
MemoSync 官网是什么?
MemoSync 开源吗?
MemoSync 安全吗?
MemoSync 还在维护吗?
MemoSync 是谁开发的?
谢谢反馈,我们会据此改进页面。