Epiphany

One private, local memory your AI tools share.

Every AI you use forgets you the moment the chat ends. You re-explain the same context over and over, and when a session dies, the reasoning behind it is gone for good. Epiphany fixes that. It's a single memory that lives on your machine, that Claude, Grok, Gemini, and more all read from and write to, so what you tell one, the others already know.

• Local-first. Your brain is a file on your disk. Nothing leaves the machine. No account, no cloud, no company owns your memory.
• Cross-model. One shared memory across Claude (Desktop + Code), Grok, Gemini, Cursor, and Antigravity. Tell Grok something, ask Claude about it.
• Real memory, not bullet points. Thoughts carry their reasoning and connect into a graph, so recall returns why something is true and what it followed from, not a lone fact. Ask a follow-up and it holds the thread.
• Never lose a session. A background sweep reads the transcripts your tools already write to disk and files every session into the brain, even ones that crashed before anything was saved.

---

How it works

Epiphany is a local MCP server plus a tiny CLI.

1. It runs a small server on your machine that exposes two tools to any AI client: recall and remember.
2. epiphany connect <tool> wires that server into each AI tool, in the tool's own config format, and installs a standing rule so the agent reaches for your memory on its own.
3. Memories are embedded on-device (a local model, nothing sent anywhere) and stored in SQLite. Agents wire explicit reasoning connections between thoughts (because, builds_on, part_of, ...), and recall walks that graph to reconstruct the whole thought-string.
4. A scheduled ingestor sweeps your tools' session logs into the brain so nothing is ever lost.

The intelligence stays in the models you already use. The brain itself is a fast, private librarian: it holds, connects, and recalls. It never phones home.

---

Quickstart

Requires Node 18+.

git clone https://github.com/GATSV-tech/epiphany.git
cd epiphany
npm install
npm run build
npm link          # puts the `epiphany` command on your PATH

Wire it into the tools you use, then fully restart each one:

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

Turn on the background "never lose a session" sweep:

epiphany schedule

That's it. Now talk to any connected AI. It will recall what you've told the others and save what's worth keeping, on its own.

---

Supported tools

Tool	Connector	Standing rule
Claude Code (every terminal)	auto	auto
Grok CLI	auto	auto
Gemini CLI	auto	auto
Antigravity (Google IDE)	auto	shared with Gemini
Claude Desktop	auto	guided (account setting)
Cursor	auto	guided (app setting)

---

Commands

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 ingest           sweep session logs into the brain now
epiphany schedule         install the background auto-ingest (every 10 min)

Your brain lives at ~/.epiphany/brain.db. It's yours. Back it up, inspect it, delete it, it's just SQLite.

---

Roadmap

Epiphany's core, local cross-model memory with reasoning graphs and automatic capture, works today. Next:

• More session sources for the ingestor (Claude Code, Cursor transcripts).
• Reconciliation. When a fact changes, the brain flags the conflict and you confirm the update, so memory self-corrects instead of piling up contradictions.
• Cloud bridge. An optional relay so cloud-only surfaces (ChatGPT on the web, wearables) can reach your local brain.
• Desktop app. A download-and-run shell for people who don't live in a terminal.
• One-line install via npm.

Contributions and ideas welcome.

---

License

MIT.