{
  "markdown": "# Epiphany\n\n**One private, local memory your AI tools share.**\n\nEvery 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.\n\n- **Local-first.** Your brain is a file on your disk. Nothing leaves the machine. No account, no cloud, no company owns your memory.\n- **Cross-model.** One shared memory across Claude (Desktop + Code), Grok, Gemini, Cursor, Antigravity, Warp, Hermes, and Perplexity. Tell Grok something, ask Claude about it.\n- **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.\n- **Never lose a session.** A background watcher reads the transcripts your tools already write to disk and files every session into the brain in near-real-time, even ones that crashed before anything was saved.\n\n---\n\n## How it works\n\nEpiphany is a local [MCP](https://modelcontextprotocol.io) server plus a tiny CLI.\n\n1. It runs a small server on your machine that exposes two tools to any AI client: `recall` and `remember`.\n2. `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.\n3. 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.\n4. A background watcher sees your tools' session logs the moment they change and sweeps them into the brain, so nothing is ever lost.\n\nThe 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.\n\n---\n\n## Quickstart\n\nRequires Node 18+.\n\n```bash\nnpm install -g epiphany-mcp   # puts the `epiphany` command on your PATH\n```\n\nOr build from source:\n\n```bash\ngit clone https://github.com/GATSV-tech/epiphany.git\ncd epiphany\nnpm install\nnpm run build\nnpm link\n```\n\nWire it into the tools you use, then fully restart each one:\n\n```bash\nepiphany connect claude-code\nepiphany connect grok\nepiphany connect gemini\nepiphany list          # see all supported tools\n```\n\nTurn on the background \"never lose a session\" sweep:\n\n```bash\nepiphany schedule\n```\n\nThat'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.\n\nRun `epiphany` with no arguments any time to open the dashboard and look inside your brain.\n\n---\n\n## Supported tools\n\n| Tool | Connector | Standing rule |\n|---|---|---|\n| Claude Code (every terminal) | auto | auto |\n| Grok CLI | auto | auto |\n| Gemini CLI | auto | auto |\n| Antigravity (Google IDE) | auto | shared with Gemini |\n| Claude Desktop | auto | guided (account setting) |\n| Cursor | auto | guided (app setting) |\n| Warp (terminal, Agent Mode) | auto | guided (app setting) |\n| Hermes (Nous Research agent) | auto | guided (instructions) |\n| Perplexity (Mac app) | guided | guided (instructions) |\n\n---\n\n## Commands\n\n```\nepiphany connect <tool>   wire Epiphany into an AI tool (connector + rule)\nepiphany rule <tool>      update just the standing rule for a tool\nepiphany list             show supported tools\nepiphany dash             open the interactive dashboard (browse, search, curate)\nepiphany graph            see your whole brain as an interactive visual graph\nepiphany weave            wire the reasoning connections between related memories (optional; uses your LLM key)\nepiphany status           show brain size, connected tools, and auto-capture state\nepiphany ingest           sweep session logs into the brain now (one-shot)\nepiphany watch            run the near-real-time watcher in the foreground\nepiphany schedule         install the background watcher (captures sessions as they happen)\n```\n\nYour brain lives at `~/.epiphany/brain.db`. It's yours. Back it up, inspect it, delete it, it's just SQLite.\n\n---\n\n## Roadmap\n\nEpiphany's core, local cross-model memory with reasoning graphs and automatic capture, works today. Next:\n\n- **More session sources** for the ingestor (Claude Code, Cursor transcripts).\n- **Reconciliation.** When a fact changes, the brain flags the conflict and you confirm the update, so memory self-corrects instead of piling up contradictions.\n- **Cloud bridge.** An optional relay so cloud-only surfaces (ChatGPT on the web, wearables) can reach your local brain.\n- **Desktop app.** A download-and-run shell for people who don't live in a terminal.\n\nContributions and ideas welcome.\n\n---\n\n## License\n\nMIT.\n",
  "bytes": 4949,
  "sha": "19a6183254340165ebd96778f8f706a86f8e48d530830c23852d30e1ca808108",
  "repo_slug": "gatsv-tech/epiphany",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gatsv_tech_epiphany_879d4525/readme"
}