epiphany

Epiphany

一份私有的本地记忆，供你的 AI 工具共享。

每个你使用的 AI 都会在聊天结束时忘记你。你得一遍又一遍地重复说明相同的背景信息，而会话一旦结束，其中的推理过程也会永远消失。Epiphany 解决了这个问题。它是一份保存在你自己的机器上的统一记忆，Claude、Grok、Gemini 等都可以读取和写入，因此你告诉其中一个 AI 的内容，其他 AI 也已经知道。

• 本地优先。 你的大脑就是磁盘上的一个文件。任何内容都不会离开这台机器。无需账户，也不上云，没有任何公司能拥有你的记忆。
• 跨模型。 Claude（Desktop + Code）、Grok、Gemini、Cursor、Antigravity、Warp、Hermes 和 Perplexity 共用一份记忆。告诉 Grok 一件事，再问 Claude。
• 真正的记忆，而非要点。 想法会保留其推理过程，并彼此连接成图，因此回忆时能找回某件事为什么成立、它源自什么，而不只是一条孤立的事实。继续追问时，它也能接上话题。
• 永不丢失会话。 后台监视器会读取你的工具本来就会写入磁盘的会话记录，并近乎实时地将每次会话归档到大脑中，即使会话在保存任何内容之前就崩溃了也不例外。

---

工作原理

Epiphany 是一个本地 MCP 服务，加上一个小巧的命令行工具。

1. 它会在你的机器上运行一个小型服务，向任何 AI 客户端提供两个工具：recall 和 remember。
2. epiphany connect <tool> 会按照每个 AI 工具自己的配置格式，将该服务接入工具，并安装一条常驻规则，让 Agent 主动调用你的记忆。
3. 记忆会在设备本地生成嵌入向量（使用本地模型，不会将任何内容发送到别处），并存储在 SQLite 中。Agent 会在想法之间建立明确的推理连接（because、builds_on、part_of，等等），而回忆功能会遍历这张图，还原完整的思路链。
4. 后台监视器会在工具的会话日志发生变化时立即发现，并将其归档到大脑中，因此任何内容都不会丢失。

智能仍由你已经在使用的模型提供。大脑本身就是一个快速、私密的资料管理员：它保存、连接并找回记忆，从不连接外部服务。

---

快速开始

需要 Node 18+。

npm install -g epiphany-mcp   # puts the `epiphany` command on your PATH

或者从源代码构建：

git clone https://github.com/GATSV-tech/epiphany.git
cd epiphany
npm install
npm run build
npm link

将其接入你使用的工具，然后将每个工具完全重启：

epiphany connect claude-code
epiphany connect grok
epiphany connect gemini
epiphany list          # see all supported tools

开启后台“永不丢失会话”归档功能：

epiphany schedule

就这么简单。现在，和任意一个已连接的 AI 对话。它会主动回忆你告诉过其他 AI 的内容，并保存值得保留的信息。

随时运行不带参数的 epiphany，即可打开仪表板，查看你的大脑。

---

支持的工具

工具	连接器	常驻规则
Claude Code（所有终端）	自动	自动
Grok CLI	自动	自动
Gemini CLI	自动	自动
Antigravity（Google IDE）	自动	与 Gemini 共用
Claude Desktop	自动	引导设置（账户设置）
Cursor	自动	引导设置（应用设置）
Warp（终端，Agent Mode）	自动	引导设置（应用设置）
Hermes（Nous Research Agent）	自动	引导设置（说明）
Perplexity（Mac 应用）	引导设置	引导设置（说明）

---

命令

epiphany connect <tool>   wire Epiphany into an AI tool (connector + rule)
epiphany rule <tool>      update just the standing rule for a tool
epiphany list             show supported tools
epiphany dash             open the interactive dashboard (browse, search, curate)
epiphany graph            see your whole brain as an interactive visual graph
epiphany weave            wire the reasoning connections between related memories (optional; uses your LLM key)
epiphany status           show brain size, connected tools, and auto-capture state
epiphany ingest           sweep session logs into the brain now (one-shot)
epiphany watch            run the near-real-time watcher in the foreground
epiphany schedule         install the background watcher (captures sessions as they happen)

你的大脑位于 ~/.epiphany/brain.db。它属于你。你可以备份、检查或删除它；它只是一个 SQLite 数据库。

---

路线图

Epiphany 的核心功能——本地跨模型记忆、推理图和自动捕获——现在已经可以使用。接下来计划：

• 更多会话来源，供采集器使用（Claude Code、Cursor 会话记录）。
• 信息协调。 事实发生变化时，大脑会标记冲突，由你确认更新，让记忆自行修正，而不是不断积累矛盾。
• 云端桥接。 提供可选的中继，让仅支持云端的入口（网页端 ChatGPT、可穿戴设备）也能访问你的本地大脑。
• 桌面应用。 为不常使用终端的人提供下载即运行的应用外壳。

欢迎贡献代码和提出想法。

---

许可证

MIT。