vshulcz/deja-vu has 1,516 GitHub stars and 181 forks. GitHot measured +20 stars in 24 hours and +120 in 7 days. Last checked 2026-11-11 22:30 UTC. Last push 2026-11-02.
Claude Code memory, Codex memory, Cursor memory, OpenCode memory, Gemini CLI memory, Windsurf memory & Cline memory across 44 agents. AI coding memory, Claude Code history, Cursor history, local coding agent memory, MCP memory server & Claude compaction.
できること
- Starts full on day one. Months of existing transcripts across all forty-three agents are searchable immediately — fix a bug in Codex and Claude Code, Cursor or OpenCode recalls it.
- Automatic recall via hooks & MCP. Surfaces prior sessions at session start, before a file edit or command runs, and when a command fails.
- Survives compaction. Over 43 measured compactions, summaries kept 77% of decisions and 0.2% of commands; deja hands back the rest (how).
- Indexes code changes, not just chat. Tracks opened files, commands with exit codes, and exact Edit spans (deja blame <file>:<line>, deja restore <path>).
計測したスター増加
- 24時間
- +20
- 7日間
- +120
- 15日間
- 履歴を収集中
- 1か月
- 履歴を収集中
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
docs/readme/README.ja.md
オリジナル
解決済みの問題を、コーディングエージェントにもう一度デバッグさせない。
Claude Code、Codex、Cursor、OpenClaw、Gemini CLI、OpenCode、Hermes をはじめとする 43 のエージェントは、すべてのセッションをすでにディスクに保存しています。
deja はそれをローカルでインデックス化し、MCP とフック経由で必要な履歴を渡します——LLM 不要、単一の Go バイナリ。
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Português | Français | Deutsch | Русский | Türkçe | हिन्दी
ドキュメント · ブラウザデモ · ベンチマーク · 他ツールとの比較 · 自分のツールへの組み込み
curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto
| 再現率 LongMemEval-S で 97.2% R@5 全 500 問 · MemPalace 96.6%、agentmemory 95.2% 同じ 19,195 セッションで 1 位正解 19/100、次点は 14 |
トークン agentmemory の半分のトークン 解決済みのタスクで 53,558 対 104,974 ツール定義は 1 ターン 477 トークン、7 つの中で最少 |
インデックス時間 19,195 セッションを 13.6 秒でインデックス 7 ツール中の次点は 72 秒 最初の回答まで 26 ms、検索の中央値 97 ms |
ドライバ、合成コーパス、採点ルールはすべてこのリポジトリにあります · 直接比較と、疑わしい行の再実行方法 · LongMemEval と LoCoMo の実行結果
インストール
curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto
スクリプトはバイナリを ~/.local/bin に置きます。このディレクトリがまだ PATH にない場合、同じシェルでは 2 つ目のコマンドが見つかりません。スクリプトが表示するフルパス付きの next: 行を実行するか、PATH の行を追加したあとで新しいシェルを開いてください。
インストールに 10 秒、インデックス作成に約 10 秒で、すぐに使えます。2 つ目のコマンドは、見つかったすべての エージェントに MCP リコールを接続し、対応しているエージェントではセッション開始時のリコールを有効にし、 最初のインデックスを作成するので、次のセッションでその待ち時間は発生しません。
新しいエージェントセッションを開始して、何か月も前に取り組んだことを聞いてみてください：
have we dealt with jwt refresh rotation before? check your memory
頼む必要すらありません——自動リコールを有効にしていれば、セッションを開いた時点で、
エージェントはそのプロジェクトで解決済みのことをすでに知っています。自分で探すなら deja を実行してください。
その他のインストール方法と、すべては不要な場合の設定
brew install deja-vu、go install github.com/vshulcz/deja-vu/cmd/deja@latest、
または何もインストールせずに試すなら npx @vshulcz/deja-vu "query"。MCP サーバーをバンドルとして
受け付けるデスクトップアプリでは、最新リリースの
.mcpb を開けます。バイナリも同梱されています。
Claude Code、Cursor、Qwen、OpenClaw では、それぞれのマーケットプレイスから
同じプラグインバンドルを入れることもできます（Codex には専用のバンドルがあります。下の
独自パッケージを持つハーネスを参照）。Copilot CLI もこれを
インストールできますが、取り込むのはスキルだけなので、そちらでは deja install copilot-auto を使ってください：
claude plugin marketplace add vshulcz/deja-vu && claude plugin install deja-vu@deja-vu
Windows ではインストールスクリプトが unsupported OS で終了します——シェルスクリプトだからです。
代わりに Scoop（標準の main バケットにあります）か、Windows に最初から入っている winget を使ってください：
scoop install deja-vu
winget install vshulcz.deja-vu
または最新リリースから
deja-vu_<version>_windows_amd64.zip を取得し、deja.exe を PATH の通った場所
（例：%USERPROFILE%\.local\bin）に置いてください。
検索だけならバイナリ単体で完全なインストールです。インデックス作成、検索、show、ctx、blame、
--json、秘匿化（リダクション）には他に何も要りません。deja install は MCP をエージェントに接続し、
セッション開始時のリコールを有効にするためのもので、あると便利ですが任意です。バイナリのみの構成では
deja doctor がすべての MCP ターゲットを config missing（エージェントが入っている場合は not-wired）と報告しますが、これはその構成として想定どおりの
動作です。deja warmup は ~/.agents/skills/deja-search/SKILL.md にスキルも配置します。このスキルは
エージェントに CLI の使い方——deja recall、ctx、blame、recall ページの読み方と次のページの取り方——を教えるので、
MCP なしでも履歴を検索できることをエージェントが理解できます。リポジトリ内のコピーは
skills/deja-search/SKILL.md です。
deja install --all は、セッション開始時のリコールを除いた --auto です。エージェントは各セッションを
記憶とともに始めるのではなく、自分で呼び出すと判断したときに記憶から答えます。
エージェント設定ガイドでは、各ハーネスの対応状況、
aider の読み取り専用コンテキストファイル、Windows の cmd /c deja mcp ラッパーについて説明しています。
各エージェント自身のガイダンスファイルに書き込まれる内容
インストール時には、検出したハーネス向けにユーザーレベルのガイダンスも書き込みます。Claude Code、Codex、opencode、Gemini CLI、Antigravity、Qwen、Kimi Code、pi、Senpi、Copilot、VS Code Copilot Chat、Cursor、Goose、OpenClaw、Hermes、Roo Code、omp、Amp、prime-agent、DeepSeek Harness、Continue、Crush、CodeBuddy Code、WorkBuddy、Zed、TRAE CLI、TRAE IDE、Muse Code、CodeWhale、ZCode、Junie は、それぞれ自身のガイダンスファイル（または設定された XDG_CONFIG_HOME 配下）に書き込まれます。再実行すると、周囲のユーザー記述はそのままに、deja のスキルまたはマーク付きブロックだけを書き換えます。オプトアウトするには deja install --all --no-guidance を使ってください。Grok Build と Devin CLI には、それらが読み込む ~/.agents/skills に共有スキルが置かれます。その横に書かれる ~/.grok/GROK.md は、同じディレクトリを使う無関係なコミュニティ製 CLI 向けです。Cursor にはユーザーレベルの指示ファイルがないため、Cursor がスキルを読み込む 4 か所のひとつである ~/.agents/skills に共有スキルが置かれます——毎セッションではなく、関連がありそうなときにだけ読み込まれます。Kilo Code、gajae-code、Kimchi、Command Code、Cherry Studio、Reasonix にはスキルが、Kiro にはスキルとステアリングファイルが、それぞれ専用のインストールターゲットから書き込まれます。
自分で検索する
ターミナルで引数なしの deja を実行すると、全エージェントの履歴を検索する画面が開きます。最初に並ぶのは
まだコミットしていない変更の背景にあるセッション、次にこのプロジェクトの最近のセッションで、入力するたびに
一覧が絞り込まれます。
↑↓でセッションを選び、↵で一致箇所から開き、nとNで一致箇所を移動し、escで戻ります。セッションの中では/で語を探し、]と[で自分の質問から質問へ移動します。- 検索欄はフィルタも受け付けます。コロン付きのエージェント名（
codex:）、today、yesterday、week、month、in:<project>です。 rはセッションを書いたエージェントで再開します。oは別の任意のエージェントで続けます。そのエージェントは、セッションが何を尋ね、何を決め、何を未解決のまま残したかを持った状態で始まります。tabで「このプロジェクト」「すべてのプロジェクト」「Deleted」を切り替えます。Deleted は、エージェントが削除したが deja がまだ保持しているセッションで、Rでひとつを元に戻せます。?ですべてのキーを表示し、^kに残りの操作（セッション ID やプロジェクトのパスのコピー、セッションを忘れる）があり、リストではqで終了し、escは一段戻り、検索欄が空なら終了します。
DEJA_TUI=0 を指定すると、画面の代わりにテキストの要約を表示します。これは deja brief と同じものです。
パイプに出力した場合は、何がインデックス化されていて次にどのコマンドを実行すればよいかを表示します。
できること
Codex で解決して、Claude が覚えている。 43 のコーディングエージェントはすべての会話を ローカルファイルに書き出しています。deja はそれらのファイルを、全エージェントが読めるひとつの記憶レイヤーに変えます。
| さかのぼって検索 | deja "connection pool exhausted" で数 GB を検索。deja をインストールする前の履歴もすべて対象です。自然言語の質問は関連度ティアにフォールバックします。時間はフィルターではなくヒントとして扱われます。 |
| エージェント横断のリコール | MCP の deja ツールを recall モードで使えば、元々どのエージェントで解決したかに関係なく、尋ねたエージェントで 「これは3週間前に直した」 に答えます。 |
| コンパクションを生き延びる | 43 回のコンパクションで計測したところ、要約に残ったのは決定事項の 77%、実行したコマンドの 0.2% でした。deja は残りの 99.8% を返します——さらに Claude Code と Codex では、コンパクション開始時にタスク、ファイル、コマンドを捕捉し、その後に一度だけ返します。 |
| 行動の直前にリコール | エージェントがファイルを編集したりコマンドを実行したりする前に、deja はそのファイルに関する過去の決定、そのコマンドの動作実績のある呼び出し方、あるいはこのマシンにないプログラムを示します。コマンドが失敗すると、PostToolUse フックが、このマシンで以前同じエラーの後に何が行われたかを答えます——エージェントが自分では尋ねようとしない組み合わせです。 |
| 会話だけでなく作業もインデックス化 | 各ターンで開いたファイル、実行されたコマンドとその終了ステータス、編集で置き換えられた正確な範囲。どの要約も捨ててしまう部分です。 |
さらに 4 つ：却下された決定、情報の鮮度、同期と引き継ぎ、秘匿化
| 何が定着したかを知っている | deja promote <id> --state rejected --note "why" で、取り消した決定に印を付けます。以降そのセッションがヒットするたびに、試して却下されたことが理由とともに表示されます。何も削除されず、--state accepted で印を取り消せます。 |
| 前提が変わったら教えてくれる | ヒットには このセッションで触れた 4 ファイルがその後変更されています と表示され、判断できない場合は何も言いません。「変更なし」と断言することは決してありません。 |
| 同期と引き継ぎ | deja sync ssh laptop で記憶をマシン間で移動します。追記のみで、間にクラウドを挟みません。deja handoff --to codex は現在のコンテキストをまとめ、別のエージェントで作業を続けられるようにします。 |
| 秘匿化（リダクション） | キー、トークン、JWT、秘密鍵ブロックはインデックス作成時に取り除かれます。パターン一致なので、規則が知らない形のものは通り抜けます。境界はセキュリティモデルに記載しています。 |
あなた自身の作業の振り返り
deja stats --card はターミナルに描画します。ファイル名を渡すと、プロフィール README 用の SVG を
書き出します。他の場所に投稿するなら、PNG に変換してください——
そのページはあなたのブラウザ内で変換します。
機能の完全なリファレンスはドキュメントにあります。
プライバシー
インデックス作成と検索はローカルで完結します。ネットワークを使うのは deja update、deja sync ssh、
deja doctor のバージョンチェック、埋め込みエンドポイント（後述）に対する deja embed
（ベクトルがあれば検索時のクエリ埋め込みも）、そして対話的なコマンドが 1 日 1 回最新リリースを確認する
ことだけです。この確認はセッションのデータを送りません。DEJA_OFFLINE=1 または DEJA_NO_UPDATE_NOTICE=1
で無効にできます。
認証情報はインデックス作成時に秘匿化されます：AWS キー、api_key= や token= の代入、
Bearer トークンや生の JWT、PEM 秘密鍵ブロック、各プロバイダーのトークン、scheme://user:pass@host
形式の URL、既知のパターンに当てはまらない形の高エントロピー値、そして文章中で述べられたパスワード——
「the admin password is …」のように、他のルールが手がかりにする区切り文字がないもの。
値は [redacted:<kind>] に置き換えられ、周囲のテキストは検索可能なまま残ります。deja share と
deja sync export は、出力時にもう一度秘匿化を適用します。
元のトランスクリプトは秘匿化されません。エージェントはコマンドの出力をそのまま書き込むため、
cat .env や貼り付けた接続文字列は平文のまま残ります。deja secrets は、秘匿化が残したマーカーをもとに、
どのセッションにどの種類の認証情報が含まれているかを一覧表示します。値そのものは決して表示しません。
あるマシンでは 42 セッションに 84 件ありました（トランスクリプト内の認証情報）。
deja secrets --scrub は、まだ値を持つトランスクリプトを書き換えます。値のあった場所に同じ
[redacted:<kind>] マーカーを置き、元のファイルは隣に残します。レポートが名前を挙げた種類だけを
対象とし、エージェントが入っているセッションは書き換えず、届かなかった件数を表示します。
セッションごとのファイルを持たないストアは、そもそも書き換えられません。
deja forget は再構築したインデックスからセッションを削除し、トゥームストーンを書き込むので、後で
deja index を実行しても元の履歴から復元されることはありません。--unforget でトゥームストーンを解除します。
プロジェクトの除外は ~/.config/deja/exclude に 1 行 1 パターンで記述します。harness: で始まる行は
ストアを指定します——harness:opencode のように——deja はそのストアを走査せず、読み取りに必要なツールも要求しません。
セキュリティモデルに、データフロー、秘匿化の限界、信頼の前提、 リリースの検証方法をまとめています。
CLI
ターミナルで引数なしの deja を実行すると検索画面が開きます。クエリや下のいずれかの
コマンドを付けると、結果を出力して終了します：
$ deja "jwt refresh token"
[claude] api · Jul 8 · 8f31c0a9 — 2 matches
login started failing after refresh token rotation; jwt kid mismatch in tests
fixed by reloading jwks cache after rotateKey and adding a clock-skew test
[codex] web · Jul 1 · b77d91e2 — 1 match
refresh token cookie needed SameSite=Lax in local callback flow
履歴に尋ねる
| コマンド | 説明 |
|---|---|
deja <query> |
すべての履歴を検索します。複数語は AND、引用符で囲んだフレーズは連続したテキストを要求します。完全一致がない場合は語形変化や近い綴りを試すので、部分文字列から単語にたどり着けます（code で opencode が見つかります）。 |
deja |
ターミナルでは上の全画面検索。deja brief は代わりにテキストの要約を表示します：今日のセッション、deja が提供したもの、最近の作業、試すとよい検索。 |
deja wip |
このディレクトリで直前のセッションが何をしていたか：タスク、決着したこと、作業中のファイル、最後のコマンドとそれが失敗したかどうか——誰かが書き忘れなかったメモではなく、トランスクリプトから導き出します。 |
deja blame <path>[:line] |
どのセッションがそのファイルについて議論し、何を決め、なぜそうしたか。行を指定すると：その行を最後に変更したコミットと、その行を書いた、あるいはコミットが置き換えたテキストを書いたセッション。--attribution は行についての答えだけを出力し、--json と併用すると JSON で、--git-note と併用すると refs/notes/deja に記録します。 |
deja files <topic> |
逆方向：あるテーマに関する作業が実際に触れたファイル。 |
deja how <tool> |
このマシンで実際にどう実行されているか。以前エージェントが実行した内容から、実際のフラグ付きで示します。 |
deja fix <error> |
以前同じエラーが起きたとき、このマシンで何を実行し、エラーが再発しなかったか。merge、force push、削除は決して返しません。 |
deja friction |
3 つ以上の別々のセッションで発生したエラーを、ハーネス名付きで表示します。 |
見つけたものを活用し、マシン間で移動する
見つけたものを使う
| コマンド | 説明 |
|---|---|
deja ctx <query> |
最も一致したセッションの Markdown ダイジェスト。そのセッションが変更したコードも含み、そのままプロンプトにパイプできます。 |
deja resume <id> |
見つかったセッションを、元のハーネスで再開します。 |
deja restore <path> |
エージェントが置き換えた範囲を、その編集が記録した old_string から取り戻します。元のファイルを上書きすることはありません。 |
deja promote <id> |
セッションを、出典・タグ・ライフサイクル状態を持つ厳選ノートに凝縮します。ノートは生のトランスクリプトより上位にランク付けされます。 |
deja share <id> |
同僚向けにサニタイズしたセッションダイジェスト。シークレットは除去済みです。 |
移動と確認
| コマンド | 説明 |
|---|---|
deja sync export/import/ssh |
記憶をマシン間で移動します。ウォーターマーク付き、追記のみ、冪等です。 |
deja view |
記憶全体をひとつのローカル HTML ファイルとして出力します。サーバーは不要で、ファイルがマシンの外に出ることはありません。 |
deja stats |
エージェント作業の振り返り。--card でターミナルに描画、--card <file>.svg でプロフィール用 SVG を書き出し、--html で閲覧可能なタイムラインを生成します。 |
deja secrets [--scrub] |
どのセッションの元トランスクリプトに、どの種類の認証情報が含まれているか。値は決して表示しません。--scrub は届く範囲を書き換え、元のファイルは隣に残します。 |
deja doctor [--deep] |
自己診断。--deep を付けると、インデックスがソースと一致していることを検証します。 |
deja mcp |
stdio MCP サーバー。deja install が接続するのはこれです。 |
MCP ツール
サーバーは mode を持つ deja というツールをひとつ公開しています。deja install が接続するので、
これが必要になるのはエージェントを手動で設定する場合だけです。以前の 6 つのツール名
（recall、recall_context、blame、fix、how、remember）も、すでにそれらに接続されているものに対しては引き続き応答します。
ツールを 7 つではなくひとつにしたのは、見た目ではなくコストの問題です。接続された MCP サーバーは リクエストのたびにツール定義を送るので、エージェントが何も呼ばなくても毎ターン費用がかかります。 ここでは 477 token、day zero で測った 7 つのサーバーのうち最大のものは 8,283 token でした。deja 自身も、スキーマをモード付きのツール ひとつに絞るまでは 828 token でした。
引数と戻り値の形式
| ツール | 引数 | 戻り値 |
|---|---|---|
deja |
mode、q、harness?、project?、limit? |
モードによって異なります（下表）。 |
q には、そのモードが尋ねる内容を入れます。以下のモードごとの引数名も引き続き受け付けますが、
スキーマは呼び出しの有無にかかわらず毎ターン読まれるため、宣言はしていません。
| モード | q の中身 |
ほかに読む引数 | 戻り値 |
|---|---|---|---|
recall |
正確な語を 1〜3 個（ファイルパス、エラー文字列、フラグや識別子） | harness?、limit?、offset? |
密度の高い一致スニペット（上限 4KB）。 |
context |
recall と同じ | harness? |
最も一致したセッションの Markdown ダイジェスト。 |
blame |
ファイルパス | harness?、project?、since?、limit?、all? |
そのファイルについて議論したセッション。 |
fix |
失敗した出力をそのまま | limit? |
以前同じエラーの後に、このマシンで実行または変更された内容。 |
how |
ツールや対象（例：go test） |
project?、limit? |
ここでエージェントが実行した内容に基づく、実際の呼び出し方。 |
orient |
なし（プロジェクトについて尋ねます） | project?、limit? |
過去のセッションがここで実行したコマンドと、作業したファイル。 |
remember |
恒久的な事実や決定をひとつ | project?、tags? |
後でリコールするために、恒久的な決定を保存します。 |
handoff |
セッション ID またはハーネス名。空ならここでの最新セッション | harness? |
別のセッションの目標、継続中の指示、最新の結論、通ったチェック、止まった位置。そのセッションを続けるためのものです。 |
対応ハーネス
自動リコールをインストールすると、Claude Code と Codex はコンパクション開始時に deja へ
トランスクリプトを渡し、deja は要約が捨てようとしているもの——タスク、結論、
各コマンドとその結果、未解決のこと——を保持します。同じセッションとワークスペースに対する次のフックが、
4 KB の予算内でそれを一度だけ返し、その後リポジトリが変化したかどうかを示す一行を添えます。deja stats
は、コンパクション後に最初の編集が行われるまでのツール呼び出し回数を数えます。これがこの機能の効果を
測る指標です。何を読み、何を保存し、どこに限界があるかは
自動コンパクション復旧を参照してください。
aider · Amp · Antigravity · Claude Code · Cline · Codex CLI · Copilot CLI · VS Code Copilot Chat · Cursor · DeepSeek Harness · Gemini CLI · Goose · Grok Build · Hermes · Kimi Code · omp (Oh My Pi) · OpenClaw · opencode · Continue · Crush · pi · prime-agent (PrimeIntellect) · Qwen Code · Cherry Studio · Senpi · gajae-code · Kimchi Coding · Command Code · ZCode · Kiro · Kilo Code · Roo Code · Zed · Devin CLI · CodeWhale · Junie · JetBrains AI Assistant · Windsurf / Devin Desktop · CodeBuddy Code · Reasonix · TRAE CLI · Muse Code · MiniMax Code.
各ハーネスの対応状況
| ハーネス | MCP リコール | 自動リコール | スキル | コマンド | 再開 | 引き継ぎ | 必要なもの |
|---|---|---|---|---|---|---|---|
| aider | ⚠ | ✅ | ✕ | ⚠ | ✕ | ✅ | deja aider |
| Amp | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 0.0.1774963753 以降のスレッドは ampcode.com 上にあり、deja はプラグインが書き出したものと、それ以前のローカルのものを読みます |
| Antigravity | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Claude Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Cline | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Codex CLI | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Copilot CLI | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| VS Code Copilot Chat | ✅ | ✅ | ✅ | ✅ | ✕ | ✅ | — |
| Cursor | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | sqlite3（IDE チャット、CLI のツール出力） |
| DeepSeek Harness | ✅ | ✅ | ✅ | ✅ | ✕ | ✅ | zstd |
| Gemini CLI | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Goose | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | deja goose |
| Grok Build | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | sqlite3（grok-dev ストア） |
| Hermes | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | sqlite3 |
| Kimi Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| omp (Oh My Pi) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| OpenClaw | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | sqlite3（2026.8 以降のストア）、.zst アーカイブと圧縮イベント（2026.9.9 以降）用の zstd |
| opencode | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | sqlite3 |
| Continue | ✅ | ⚠ | ✅ | ✅ | ✅ | ✅ | — |
| Crush | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | sqlite3 |
| pi | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| prime-agent (PrimeIntellect) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Qwen Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| Cherry Studio | ✅ | ✅ | ✅ | ✕ | ✕ | 貼り付け | 設定 -> MCP でサーバーを一度インポートし、エージェントでスキルを有効化 |
| Senpi | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| gajae-code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| Kimchi Coding | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| Command Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| ZCode | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | CLI データベース用の sqlite3 |
| Kiro | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | CLI データベース用の sqlite3 |
| Kilo Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | CLI ストア用の sqlite3 |
| Roo Code | ✅ | ✕ | ✅ | ✅ | ✅ | 貼り付け | roo CLI（エディターのタスクはエディターで再開） |
| Zed | ✅ | ✕ | ✅ | ✅ | ✕ | 貼り付け | sqlite3 + zstd |
| Devin CLI | ✅ | ✅ | ✅ | ✕ | ✅ | ✅ | sqlite3 |
| CodeWhale | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| Junie | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| JetBrains AI Assistant | ✅ | ⚠ | ⚠ | ⚠ | ✕ | 貼り付け | なし |
| Windsurf / Devin Desktop | ✅ | ⚠ | ✅ | ✅ | ✕ | 貼り付け | なし |
| CodeBuddy Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| Reasonix | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 1.x セッション用の zstd |
| TRAE CLI | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| Muse Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | なし |
| MiniMax Code | ✅ | ✅ | ✅ | ✕ | ✅ | ✅ | deja resume と deja handoff --to mcode --exec には MiniMax Code CLI（mcode）、セッションのワークスペースには sqlite3 |
✅ 動作する · — 可能だが未実装 · ✕ ハーネス側にその仕組みがない · ⚠ ハーネス側の対応待ち · ? 未調査
TRAE IDE は接続はしますが、読み取りはしません。チャットが暗号化されたデータベースにあるためです。
deja install trae-ide は MCP サーバーとスキルを追加し、trae-ide-auto はフックを追加します。TRAE IDE が
フックを実行するのは、設定 > Hooks で有効にした後だけです。
ストアの場所をカスタマイズするには DEJA_*_ROOT 変数を使います。各エージェント自身の移動用変数も
尊重されます。セッション形式レジストリには、
ハーネスごとに観測されたパス、レコードスキーマ、ロールの対応付けがまとめられており、合成フィクスチャによって
それらの記述がパーサーと一致していることを確認しています。
独自パッケージを持つハーネス
deja install --auto は、他のハーネスと同様にこれらもすべて接続し、それが最短の方法であることに
変わりはありません。これらには各エコシステム内のパッケージもあり、CLI ではなくそこから拡張機能を
インストールする人向けです：
| ハーネス | パッケージ | インストール |
|---|---|---|
| opencode | npm opencode-deja |
opencode plugin opencode-deja |
| DeepSeek Harness | npm dsh-deja |
dsh plugin --profile web add dsh-deja |
| Zed | deja-context-server |
Zed → Extensions → deja |
| Kimi Code | プラグイン deja |
/plugins install https://github.com/vshulcz/deja-vu |
| Codex CLI | プラグイン deja-vu |
codex plugin marketplace add https://github.com/vshulcz/deja-vu の後に codex plugin add deja-vu@deja-vu |
| Grok Build | プラグイン deja |
grok plugin marketplace add vshulcz/deja-vu の後に grok plugin install deja |
| OpenClaw | ClawHub と npm @vshulcz/openclaw-deja |
openclaw plugins install clawhub:@vshulcz/openclaw-deja |
| pi（と omp） | npm @vshulcz/pi-deja |
pi install npm:@vshulcz/pi-deja |
| Hermes | メモリプロバイダー deja-memory（Hermes のプラグインカタログ内） |
hermes plugins install deja-memory、または GitHub から：hermes plugins install vshulcz/deja-vu/extensions/hermes |
どちらの方法も単独で十分で、両方を使っても問題ありません。どのパッケージもまず deja install が
書き込んだ内容を読み取ります。opencode、dsh、OpenClaw は足りないものだけを追加し、Kimi、Grok、Codex、pi は
インストーラーがすでに接続している場合は手を引きます。Zed では両方が同じサーバー ID を使います。
そのため、どの順番でインストールしても重複は生じません。
いずれもすでに入っている deja を使い、同梱のコピーはフォールバックにすぎません。
同じ検索はスキルとしても提供されており、SKILL.md を読み込むあらゆるエージェントで使えます：
npx skills add https://github.com/vshulcz/deja-vu --skill deja-search # skills CLI: Claude Code, Cursor, Goose, Copilot…
openclaw skills install @vshulcz/deja-search # ClawHub
hermes skills install vshulcz/deja-vu/skills/deja-search # Hermes
このスキルは上記のインストール手順で入れた deja バイナリを動かすもので、バイナリは同梱していません。
セマンティックリコール（任意）
DEJA_EMBED_URL で deja embed をローカルの Ollama、LM Studio、または OpenAI 互換エンドポイントに
向ければ、言い換えたクエリでもヒットするようになります。到達可能なランタイムがなくても、字句検索と
MCP リコールはそのまま動作します。OpenAI Platform は標準の API キーで使えます：
export OPENAI_API_KEY='sk-...'
export DEJA_EMBED_URL='https://api.openai.com/v1/embeddings'
export DEJA_EMBED_MODEL='text-embedding-3-small'
deja embed
DEJA_EMBED_URL が未設定の場合、deja は localhost:11434 と localhost:1234 を探索するので、
すでに Ollama や LM Studio が動いているマシンでは何もしなくても検出されます。
DEJA_EMBED_OFF=1 または DEJA_EMBED_URL=off でこの探索を無効にできます——それ以外の値を
DEJA_EMBED_URL に設定した場合は、その設定が優先されます。
認証が必要な他の OpenAI 互換エンドポイントでは、DEJA_EMBED_KEY を明示的に設定してください：
export DEJA_EMBED_URL='https://example.com/v1/embeddings'
export DEJA_EMBED_MODEL='embedding-model'
export DEJA_EMBED_KEY='...'
deja embed
DEJA_EMBED_KEY が優先されます。OPENAI_API_KEY が自動的に使われるのは HTTPS の
api.openai.com の URL に対してだけで、ローカルやサードパーティのエンドポイントに暗黙的に送られることはありません。
ベクトルの保存場所とコスト
サイドカーは index.db の中ではなく、インデックスの横に .vectors.bin として置かれます。1,024 次元の
モデルでは、Float32 ベクトルのサイズはメッセージ 1k 件あたり約 4 MB です。リモートエンドポイントが
受け取るのは、秘匿化済みでインデックス化されたテキスト（約 2k 文字に切り詰め）だけで、生のソースファイルは
決して送られません。Ollama や LM Studio を使えば、埋め込みはローカルで完結し、キーも不要です。
検証
このマシンが一度解いた作業では token が 58% 少ない · LongMemEval-S（470 問のクリーン版）で 88.9% hit@1 · LoCoMo で 71.9% retrieval hit@1 · 数 GB の履歴に対してミリ秒単位の検索
各アーム 11 回の実行で 53,558 token、記憶をつながない場合の 126,222 に対して。後のビルドで再び各 11 回：103,443 に対して 52,815 ·
1 つの作業を終えるまでの費用 ·
検索側のハーネスはどちらもこのリポジトリに含まれており、公開データセット上で数分で実行できます ·
数字をご自身で確かめてください
deja bench recall # ranking floor: 100 queries, half Russian, CI fails if recall drops
deja bench context # 30 seeded task chains plus five negative controls
deja bench block # does the answer survive into what deja hands over
deja bench prompt # what the per-prompt hook fires on, and what it fires on wrongly
deja bench ingest # what an update costs: unchanged, a turn, a new transcript, a rename, a rewrite
deja bench read # what it costs to read a database-backed store, and what one long value does to it
bench block は他のベンチでは問えない問いを立てます：正しいセッションが手元にあるとき、そのブロックは
そのセッションで決着した内容を運んでいるか。各テーマについて 8 つのセッションが議論し、そのうち 1 つが
決着をつけます。それもトランスクリプトの最後ではなく途中で——そのため、上位ヒットの最新ターンを使う
ベースラインは 0 点になり、0 点を超えるには選び取る必要があります。
| アーム | 答えを含む | トークン数の中央値 |
|---|---|---|
deja-block（セッション開始ブロック） |
1.00 | 665 |
deja-digest（コンテキストダイジェスト） |
1.00 | 1656 |
newest-turn（ベースライン） |
0.00 | 289 |
cold |
0.00 | 0 |
コンテキスト実験では、deja-recall を全履歴、単純な grep、コールドコンテキストと比較します。 デフォルトのシードでの結果：
| アーム | トークン数の中央値 | カバレッジの中央値 | ネガティブコントロールのトークン数 |
|---|---|---|---|
| deja-recall | 1,096 | 1.00 | 0 |
| full-history | 80,547 | 1.00 | 78,145 |
| naive-grep | 273,238 | 1.00 | 0 |
| cold | 0 | 0.00 | 0 |
生ログを grep するのと同じ事実カバレッジを約 250 分の 1 のトークンで、一致したセッションを丸ごと 再生するより約 70 分の 1 のトークンで実現し、関連する過去の事実がないチェーンでは何も注入しません。 コーパス生成器と関連度ラベルは、レビュー済みの普通の Go コードです。どの数字を信頼する前にも—— 私たちのものも含めて——「関連がある」が何を意味するかを確認してください。
2,419 セッション、179k メッセージ、1.9 GB のトランスクリプトを持つ実際のストアでの計測結果：
| 計測項目 | 結果 |
|---|---|
| プロセス内の検索 | 中央値 0.7–0.8 ms（deja bench recall、100 クエリ、半分はロシア語）、LongMemEval-S のヘイスタックでは約 15 ms |
deja <query> のエンドツーエンド |
そのストアで中央値約 0.2 秒：プロセス起動、全ストアの鮮度チェック、ランキング、出力を含む |
| 鮮度チェックのみ | 変更がない場合は約 50 ms |
| インデックスサイズ | 200 MB、コーパスの約 10% |
同じストアはその後 2,754 セッション、358k メッセージ、5.7 GB に増えました。 これに対するコールドなフルビルドは 71 秒かかり、232 MB のインデックスを書き出します——コーパスの 4% です。 トランスクリプトには繰り返しが多いため、割合は下がっていきます——そしてエンドツーエンドの中央値は 0.25 秒と変わっていません。
インデックスはインクリメンタルです。セッションファイルが増えたときは、そのファイルだけを読み直します。
仕組み
~/.cache/deja にあるローカルの転置インデックスです：JSONL と SQLite のストアを解析し、認証情報を
秘匿化し、records.bin とトークンバケットを書き出し、ファイルごとの状態を manifest.gob で追跡するので、
再実行時は変更分だけを取り込みます。MCP サーバー、stats、share、sync はすべてこのひとつのインデックスを
読みます。詳細は docs/ARCHITECTURE.md を参照してください。
FAQ
他のメモリツールとどう違うのですか？
| deja | メモリプラットフォーム （Mem0、Letta、memU） |
セッション検索 （cass） |
|
|---|---|---|---|
| インストール前の作業を知っている | はい | いいえ | はい |
| キャプチャ手順 | 不要、トランスクリプトがそのまま記憶 | エージェントやあなたのコードが事実を書き込む | 不要 |
| LLM や埋め込みのキーが必要 | いいえ | はい | 任意 |
| 頼まれなくてもリコールする | セッション開始時とツール実行前 | いいえ | いいえ |
engram は記録先行型ツールの中で最も優れており、 そのモデルが合うなら試す価値があります。ただし、やはり空の状態から始まり、エージェントが保存することを 選んだものしか知りません。完全な比較では 15 のツールを取り上げています。
エージェントが遅くなりませんか？
リコールはローカルインデックスに対する字句検索です： 中央値 0.7–0.8 ms で、モデルの応答を待つことはありません。フックではこれに加えてプロセス起動と ストアの鮮度チェックがかかります——19k セッションのインデックスで、プロンプトごとのフックは中央値 107 ms です。
Claude Code のセッション履歴はどこに保存されていて、検索できますか？
~/.claude/projects の下に、セッションごとに 1 つの JSONL ファイルとして保存されています。Codex は
~/.codex/sessions、Cursor は SQLite の state.vscdb に保存します。deja はそれらすべてをその場で
読み取ります。引数なしの deja はそれらを検索して読む画面を開き、deja search は同じことをスクリプトから行い、deja last は全エージェントの最近のセッションを一覧表示し、deja view は履歴全体をひとつの
ローカルページとして開きます。各エージェントのパスはセッションの保存場所を参照してください。
Claude Code のセッション履歴が消えました。もう戻りませんか？
Claude Code は 30 日より古い
トランスクリプトを削除します（~/.claude/settings.json の cleanupPeriodDays）。claude --resume が
一覧表示するのは残っているものだけです。削除前に deja がインデックス化したセッションは、ファイルが
消えた後も検索できます。詳細：ディスク上のセッションファイル。
すべてを消去するには？
deja uninstall --all
rm -rf ~/.cache/deja ~/.local/share/deja ~/.config/deja
インデックスは ~/.cache/deja、remember と promote のノートは ~/.local/share/deja、
ルール、除外リスト、フックのランチャーは ~/.config/deja にあります（XDG_DATA_HOME と
XDG_CONFIG_HOME が設定されていればその下。Windows ではノートは %AppData%\deja にあります）。
ガイド
- コンテキストと復元： エージェントは以前の会話を覚えているか？ · エージェントがコンテキストを失った · コンテキストウィンドウがいっぱい · コンパクションで失われるもの · エージェントがセッション間で忘れる理由
- 検索と再開： 昨日のセッションを再開する · 問題を解決したセッションを見つける · エージェントが修正済みのミスを繰り返す · エージェントの切り替え
- セッションファイルと運用： ディスク上のセッションファイル · 各エージェントの履歴の保存場所 · エージェントの監査 · 会話のエクスポート · マシン間での利用 · 記憶のコスト
ハーネス別：opencode · DeepSeek Harness · Kimi Code · Zed · Grok Build · Gemini CLI · Qwen Code · OpenClaw · Goose · Cline · pi と omp · Hermes
コントリビュート
make build test lint を実行してから、CONTRIBUTING.md を読んでください。ハーネスの追加は
パーサーレジストリから始めます。優先事項と対象外の事項は
ROADMAP.md にあります。初心者向けの Issue にはラベルが付いています。
サポート
バグや質問は Issues へどうぞ。 悪用可能だと思われるものは、代わりに SECURITY.md にある非公開のアドバイザリリンクから 報告してください。deja が何を読み、何をどこにも送らないか、そしてプロジェクトを除外したりセッションを 忘れさせたりする方法はプライバシーにまとめています。
ライセンス
MIT © Vladislav Shulcz