epiphany

Epiphany

AI ツールが共有する、プライベートでローカルな一つのメモリ。

どの AI も、チャットが終わった瞬間にあなたのことを忘れてしまいます。同じコンテキストを何度も説明し直し、セッションが終了すると、その背景にある推論は永久に失われます。Epiphany がそれを解決します。あなたのマシン上にある一つのメモリを、Claude、Grok、Gemini などが読み書きするため、ある AI に伝えたことを、ほかの AI もすでに把握できます。

• ローカルファースト。 あなたの記憶はディスク上のファイルです。マシンの外に情報が出ることはありません。アカウントもクラウドも不要で、あなたのメモリを所有する企業もありません。
• モデルを横断して共有。 Claude（Desktop + Code）、Grok、Gemini、Cursor、Antigravity、Warp、Hermes、Perplexity で一つのメモリを共有します。Grok に何かを伝えたら、Claude に尋ねてみてください。
• 箇条書きではなく、本物のメモリ。 思考には推論が伴い、グラフ状につながるため、思い出すときには単独の事実だけでなく、何かが正しい理由や、その根拠となった情報も返されます。追加で質問しても、話の流れが保たれます。
• セッションを決して失いません。 バックグラウンドウォッチャーが、ツールがすでにディスクに書き込んだトランスクリプトを読み、保存前にクラッシュしたセッションも含め、ほぼリアルタイムですべてのセッションを脳に記録します。

---

仕組み

Epiphany はローカルの MCP サーバーと、小さな CLI で構成されています。

1. マシン上で小さなサーバーを実行し、あらゆる AI クライアントに recall と remember の 2 つのツールを公開します。
2. epiphany connect <tool> を実行すると、各 AI ツールの独自の設定形式でサーバーを接続し、エージェントが自発的にメモリを参照するよう、常時適用されるルールを設定します。
3. メモリはデバイス上で（ローカルモデルを使い、外部には何も送信せずに）埋め込み表現に変換され、SQLite に保存されます。エージェントは思考の間に明示的な推論上のつながり（because、builds_on、part_of など）を設定し、recall はそのグラフをたどって、思考のつながり全体を再構築します。
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 のエージェント）	自動	ガイドに従って設定（手順）
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。