MemoSync

与编码 Agent 共同管理跨会话记忆,随时看清它学到了什么、用了什么、有没有照做。

Star 数
★ 396
最近更新
6 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
桌面应用网页应用命令行工具
可在哪里用
通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Bun 1.3.5+已安装并登录的 Claude Code 或 Codex,或任意提供商的 API 密钥DMG 安装包需 Apple silicon 芯片的 macOSPi 需 @earendil-works/pi-coding-agent 1.3.0+OpenCode 需 opencode 1.17.4+Shell / 命令行网络访问本地文件系统
典型场景
已经使用 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 ★

这个 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 记录每轮的提议、选择、引用、中断与审计结果,能跨越上下文压缩保留。

  1. 已经使用 Claude Code 或 Codex 的开发者,发现自己看不懂 CLAUDE.md 里到底攒了什么、Agent 这轮又用了哪几条。
  2. 团队需要每次改记忆都经过人工确认,避免 Agent 自行写坏项目规则。
  3. 在多个项目之间工作的人,想把某个项目里的通用规则迁移到另一个项目,并逐版对比改写结果。
  4. 做上下文工程研究或调参的人,想量化某条记忆对具体回合是起作用、无效还是被违反。
  5. 希望记忆和聊天记录只留在本机、不进入第三方云端的个人开发者。
  6. 需要在一轮任务跑到一半时叫停 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?

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

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。

可靠稳定6 / 14 · 2.1/5

代码注释与 README 对 SQLite 权威、Markdown 投影为导出、崩溃后重建的描述自洽,给 2;依赖可用性依赖外部 CLI(claude/codex/opencode/pi)与版本门槛,README 有说明但未提供降级或校验机制,给 1;失败信息方面仅见 console.warn 与少量 throw,用户可见错误处理证据薄弱,给 1。

适用触发9 / 18 · 2.5/5

面向 Claude Code/Codex/Pi/OpenCode 多引擎与多场景(审阅/自动)覆盖较好,给 2;能力边界(不内置 agent、仅 macOS 桌面、Windows 不支持、审计可能出错)有说明,给 2;trigger_precision 方面记忆注入默认 all-in、依赖模型判断引用与审计,触发条件较模糊,给 1;environment_fit 仅 macOS 打包、Linux 源码运行,Intel Mac 需源码,给 1。

规范维护8 / 18 · 2.2/5

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。

有效结果7 / 13 · 2.7/5

输出可用性上提供审阅卡、引用、审计结论与 Memory Board,界面与数据模型具体,给 2;边际价值在于把隐式记忆显式化并可审计,相对原生 agent 有增量,给 2;成本收益上每轮审阅开销大、依赖外部模型做审计与精炼、需自备 API key 或登录,给 1。

证据核验4 / 8 · 2.5/5

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,应确认下载来源。
证据充分度:低 评估于 2026年11月11日 审查版本 e16321576a2e 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

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

FARS

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

最近版本

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

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 自己会调用模型吗?费用怎么算?
会。软件本身是 MIT 免费开源,但记忆拆条、审计、Automatic 模式的自动整理都需要模型,费用由你自己接入的登录或 API 密钥按用量支付。
它能读取我现有的 CLAUDE.md 和 Codex 记忆吗?会不会改动它们?
可以。Import memory 会读取 Claude Code 与 Codex 的记忆文件夹,由你选择的模型拆成条目并分到个人偏好和项目记忆,审核前不落库;读取过程不修改原文件夹。
审计判定不可靠怎么办?
README 说明审计是模型判断,可能出错。每条结论都标注是审计发现还是 Agent 自述,被判定违反的条目可以点 Where used 跳到原句与工具调用自行核对。
我的数据和密钥存在哪里?
全部在 ~/.memosync/data/ 下,包括 SQLite 记忆、Markdown 副本、聊天与设置、API 连接,以及一份本机使用日志;密钥在 credentials.json 中,仅本机可读,也不会返回给浏览器。可用 MEMOSYNC_USAGE_LOG=0 关闭日志。
可以放在局域网或远程机器上访问吗?
可以,使用 bun run start --remote 监听 0.0.0.0,配合 --password 要求密码,或用 --share 生成临时公网 URL 与二维码。注意 Agent 及其终端以你的用户身份运行,可以访问你的文件,配置隔离不等于文件系统隔离。
MemoSync 官网是什么?
MemoSync 的 GitHub 仓库填写的官网是 https://memosync.cc/。这个链接由仓库作者设置;源码在 GitHub(SLEEPYBQ/MemoSync)。
MemoSync 开源吗?
开源。源码在 GitHub(SLEEPYBQ/MemoSync),许可证是 MIT。
MemoSync 安全吗?
FollowAgents 的 FARS 评审(2026年11月11日)给 MemoSync 的“信任与安全”打了 16/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
MemoSync 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-15,在最近 30 天内。最新版本是 v0.45.0(2026-11-14)。
MemoSync 是谁开发的?
MemoSync 由 GitHub 账号 SLEEPYBQ 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

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

相关核心概念