fable 是一款面向 Claude Code 的高保真转录记忆工具。它的出发点是：Claude Code 与你的每次对话其实都已保存在本机，但 Claude 本身无法使用这些历史——会话中途的压缩（compaction）会用摘要筑起一道墙，/clear 会清空记录，30 天后 Claude Code 还会自动删除这些文件。fable 的定位不是另造一套摘要或事实抽取式的“替代记忆”，而是把这些真实转录解锁出来。
主要能力
- 逐字节一致的回放（byte-identical recall）：把真实对话原样取回，而不是摘要或抽取的“事实”。
- 全文与语义搜索：索引关键词搜索；语义检索可选，依赖本机 Ollama 生成嵌入。
- 本地 SQLite 归档：包含不可变的保管库（保留每个字节）与搜索映射。
- 组合会话（Composed Sessions）：从任意项目、任意月份挑选对话，按你的顺序组合，生成一个 Claude 可作为自身经历继续的崭新会话。
- 文件时间旅行：根据转录重建每个文件由 Edit 和 Write 产生的编辑历史，支持任意两个时间点的并排比较，并可跳回产生每次改动的对话（fable file src/loader.py）。
- 转录手术（Transcript Surgery）：整段删除对话后再缝合时间线，先展示模拟结果，被删除的字节仍永久可召回，且可逆。
- 无损修剪：恢复沉重会话前精简每条消息（工具噪声、图片、冗余内容），先给出逐项节省预览，并把原件先封存进保管库。
- 记忆差异（Memory Diff）：逐代、逐字节查看任何修剪或清理对对话造成的影响。
- 冷启动运行：用 fable mute on、FABLE_MUTE=1 claude 或设置中的开关，让某个会话或一组子智能体在无任何先前上下文（不注入记忆、不提供召回工具）的情况下工作，但捕获仍在进行，取消静音后这些被静音的工作依然可逐字检索——用于获取不会被昨日结论锚定的无偏第二意见。
工作原理
fable 把转录索引进本地 SQLite 归档：一个不可变的保管库（永远保留每个字节）加一个搜索映射（关键词，以及可选的、通过 Ollama 提供的本地嵌入语义搜索）。钩子会在 Claude Code 的压缩与清理之前运行；一个 MCP 服务器为 Claude 提供搜索、召回与记忆工具。官方称在真实归档上测得 191,000 条记录、6,000 个会话的性能，并可用 python3 scripts/benchmark.py 复现，同时声明没有竞品公开检索数据。
使用方式
安装命令（官方称具有幂等性，可安全重跑，会自动跳过已接好的部分）： fable install 手动分步：fable setup（home）· claude mcp add fable -- fable mcp（MCP）· fable discover（索引）。 在会话中可直接向 Claude 询问过去对话，例如“上个月关于 auth 我们定了什么？”，Claude 会经 MCP 搜索自身历史并引用真实转录。 常用用法：fable remember “we deploy Fridays only” 记录跨会话的长期规则；fable file fable/recall.py 查看文件历史；fable --db demo/demo.db serve 在示例数据上试用（可先运行 python3 demo/seed_demo.py 生成虚构样本）。
适用场景
- 架构考古：几周后追问“为什么当初选了 X？”。
- 定位某函数何时出错：用文件时间旅行找到确切编辑及相关对话。
- 在压缩筑墙处接续调试线索。
- 组装“工作区”会话：把三个项目的线索合入同一份记忆。
- 在 --resume 之前可逆地精简沉重会话。
- 保存长期约定，如“只在周五部署”。
限制与说明
fable 为本地优先、仅使用标准库、基于 MCP，采用 MIT 许可。官方称其非目标（non-goals）表明本地优先是长期方向。语义检索依赖可选的本地 Ollama 嵌入；未使用嵌入时语义能力是否可用，资料未明确说明。价格、平台支持范围等细节暂未提供。官方说明 mem0 更适合多 LLM 的生产级智能体，ccusage 更深入计费分析，任务不同且都可与 fable 兼容。
