deja-vu は、コーディングエージェントに記憶を持たせるOSSだ。ただし方向が他と逆で、新しく記憶を書かない。Claude Code・Codex・Cursor ほか40以上のエージェントが既にディスクへ書き残したセッション記録をそのまま索引し、新しいセッションが始まったときに関連する過去のセッションを返す。Go製・MIT・star 1.3k・fork 156。本記事は読者からの題材提供を受け、最新の v0.23.3 を取得して、公称値を独立に測り直したものだ(数値はすべて当サイトが実測したか、出典を明示して引用している)。

WRITE VS READ記憶の向きが逆

新しく書くか、既にある履歴を読むか

書いて憶える型(Mem0・Letta・memU)

履歴を読む型(deja-vu)

書いて憶える型(Mem0・Letta・memU): 会話から事実を抽出して別の場所に保存

履歴を読む型(deja-vu): Claude Code 等が既に書いた記録をそのまま索引

書いて憶える型(Mem0・Letta・memU): 抽出に LLM・API キーが要る構成がある

履歴を読む型(deja-vu): 既定は LLM もキーも不要の語彙検索(BM25)

書いて憶える型(Mem0・Letta・memU): 入れた日は空、育つまで効かない

履歴を読む型(deja-vu): 入れた瞬間から過去ぶんが引ける

書いて憶える型(Mem0・Letta・memU): 返るのは抽出・要約された『事実』

履歴を読む型(deja-vu): 返るのは実在した発話そのもの(生成しない)

出典: vshulcz/deja-vu README・internal/sources(2026-10-31・v0.23.3 確認)。優劣でなく設計の向きの違い

30秒でわかるdeja-vu(v0.23.3・2026-10-31実測)

  • ・既存のセッション記録を読むだけ。LLMも生成も使わないので入れた日から過去ぶんが引ける。
  • ・公式 v0.23.3 の linux/amd64 バイナリは 21,729,442バイト(約21.7MB)。持ち込まれた公称18.6MB・旧版の14.9MBとも違い、版で動く。
  • ・対応は registry.go で43系統(README の「40エージェント」を裏づけ)。
  • ・公称ベンチは 97.2% R@5・19,195セッションを13.6秒。ただしこれは検索側の指標で、LLMの回答精度ではない。

エージェント基盤の全体像はAIエージェントフレームワーク比較2026|LangGraph・CrewAI・Dify等9種をStar数・実コードで検証にまとめてある。本記事はその周辺部品である「記憶」を、設計の向きが違う1本として測る。

deja-vuとは:新しく憶えず、既にある履歴を読む

発想は単純だ。Claude Code は ~/.claude/projects/ 以下にセッションの全文を JSONL で書いている。Codex も Cursor も opencode も、形式は違えど同じことをしている。その記録は既にそこにあるのに、次のセッションからは誰も読まない。 deja-vu はそこを索引するだけの道具だ。

導入は2行で、索引してから手元の履歴量を確かめる。

# 公式のインストール一行(macOS/Linux。Homebrew・Scoop・winget・npm・go install も可)
curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto        # 検出したエージェントへ索引とフックを配線

# 手元に何セッション・何メッセージ・何MBあるかを見る(薄ければ効果も薄い)
deja sources

HOW IT WORKS読む→索引→返す

ディスク上の記録を読み、関連する過去を返す

  1. 既にある記録(40+系統)

    Claude Code・Codex・Cursor ほか、registry.go で約43系統。~/.claude の JSONL や opencode/zed の SQLite を直接読む

  2. deja index で索引

    ローカルに索引を作る。索引時に鍵・トークン・JWT・PEM を秘匿(パターン一致=未知の形は通り抜けうる)

  3. ローカル索引(ネットに出ない)

    既定は LLM もキーも不要の語彙検索。埋め込みは任意(DEJA_EMBED_URL、未設定なら localhost を探索/OFF可)

  4. MCP1本+フック+CLIで返す

    関連する過去の発話をそのまま返す。生成はしない。記録に無いことは引けない

出典: vshulcz/deja-vu README・internal/sources/registry.go(2026-10-31・v0.23.3 確認)

読む先は JSONL だけではない。opencode や zed は SQLite に書くので、そちらは DB を直接読む。索引はローカルに作られ、既定の状態ではネットワークに出ない。ソースの internal/sources/registry.go を数えると、登録されたハーネスは 43系統(deja 自身や copilot の2系統を含む)で、README の「40エージェント」はおおむね裏づけられた。Claude Code・Codex・Cursor・Gemini・Copilot に加え、Cline・Roo・Kilo Code・Aider・Zed・opencode・Windsurf・Devin・JetBrains 系まで並ぶ。裏返すと、これは「エージェントを乗り換えても履歴は残る」ことに賭けた設計だ。ツールを替えるたびに記憶がゼロに戻る問題を、記憶の側ではなく読み取りの側で吸収しようとしている。

検索は、引数なしで端末から対話的に、あるいは語を渡して一発で引ける。履歴に対する問い合わせの入口も多い。

deja "goroutine leak"          # 過去セッションを語彙検索(要約でなく当時の発話が出る)
deja blame path/to/file.go:42  # この行はどのセッションで決まったか(git blameの会話版)
deja secrets                   # 記録に混ざった認証情報を点検(--scrub で該当を書き換え)

生成が一切ないので、返ってくるのは過去の発話そのものだ。要約でも抽出された「事実」でもない。ここが mem0 や Letta との決定的な違いで、記録に無いことは絶対に出てこない代わりに、出てきたものは必ず実在した発話になる。索引時には、鍵・トークン・JWT・PEM ブロックといった秘匿情報をパターンで取り除く処理が入る。ただしこれはパターン一致なので、規則が知らない形のものは通り抜けうるとプロジェクト自身が明記している。過信は禁物だ。

公称と実測:21.7MBと「40エージェント」を確かめる

持ち込まれた説明には「18.6MBのバイナリ」「19,195セッションを17.6秒」とあった。順に現物で確かめる。

バイナリのサイズ。 公式リリースを取得して実測した。

curl -fsSL -o deja.tar.gz \
  https://github.com/vshulcz/deja-vu/releases/download/v0.23.3/deja-vu_0.23.3_linux_amd64.tar.gz
tar xzf deja.tar.gz
./deja --version     # deja 0.23.3
stat -c%s ./deja     # 21729442 バイト(約21.7MB)

公式リリース v0.23.3 の linux/amd64 を展開すると 21,729,442バイト(約21.7MB)。持ち込まれた18.6MBより大きく、当サイトが前回(v0.21.4・2026-09-30)に測った14.9MBからも増えている。つまりこの数字は版で動くので、特定の版を指して書かないと古くなる。配布 tar.gz 自体は約8.9MBだった。

索引の速度とベンチ。 現行 README の公称は、19,195セッションを 13.6秒で索引(7ツール中の次点は72秒)、最初の回答まで26ms、検索の中央値97ms——というものだ。持ち込まれた「17.6秒」は旧版の値で、現行とは違う。これらの速度や後述の再現率はプロジェクト自身が公開しているベンチ値で、ドライバ・コーパス・採点規則がリポジトリに同梱され再実行できる形になっているが、当サイトは今回このベンチ自体は再実行していない。前回は合成コーパスで索引の桁(毎秒千数百セッション)が合うことだけは確認している。

鍵とサーバー。 既定で鍵もエンドポイントも要らないことは、前回 v0.21.4 で鍵ゼロのまま索引・検索が通ることを実測済みだ。埋め込みによる意味検索だけが任意で、DEJA_EMBED_URL 未設定時は localhost:11434(Ollama)と 1234(LM Studio)を探しに行き、DEJA_EMBED_OFF=1 で止められる。

ベンチの読み方:97.2% R@5が指すもの

もう一つの公称が「LongMemEval-Sで97.2%」だ。これは性質を取り違えやすいので分けて書く。

READ THE NUMBERS公称値の読み方

速い・軽いは公称、再現できるのが要点

  1. 1.97.2% R@5 は検索側の指標

    LongMemEval-S(500問)での再現率。MemPalace 96.6%・agentmemory 95.2%。LLMの最終回答精度ではなく『正しいセッションを引けたか』

  2. 2.13.6秒・トークン半分は著者公称

    19,195セッションを13.6秒(7ツール中の次点は72秒)、agentmemoryの約半分のトークン。ドライバ・コーパス・採点規則はリポジトリにあり再現可能

  3. 3.まず自分の履歴量を見る

    deja sources で手元の履歴が何セッション・何MBか分かる。薄ければ効果も薄い。入れた瞬間に効くのが最大の利点

  4. 4.記録に無いことは引けない

    考えただけ・口頭・別マシンの作業は対象外。抽出型の記憶とは排他でなく補完。索引前に deja secrets で秘匿情報を点検

出典: vshulcz/deja-vu README/docs(公称値・著者ベンチ。当サイトは再実行していない)。2026-10-31 確認

97.2% R@5 は、LongMemEval-S(500問)での検索の再現率だ(MemPalace 96.6%・agentmemory 95.2%)。R@5 は「根拠セッションのどれかが上位5件に入れば正解」とする指標で、LLMが出す最終回答の精度ではない。別の見方では 88.9% hit@1(470問の整理版)、LoCoMo で 71.9% hit@1 とも公称されている。トークン面では、一度解いた課題で agentmemory の約半分(53,558対104,974)とされる。いずれも「検索が正しいセッションを引けたか」と「同じ答えをより少ないトークンで運べたか」の指標で、ここを「回答精度97%」と読むと過大評価になる。

評価できるのは、これらを追試できる形で開示していることだ。コーパス・採点規則・各ツールのドライバがリポジトリに入っていて、疑う行は自分で回せる。公称値をそのまま信じる必要がない構成自体が、この道具の誠実さを示している。

mem0・Hindsightと並べる

同じ「記憶OSS」でも、設計の向きが違うことがはっきり出る。当サイトが実測した2本と並べる。

  mem0 Hindsight deja-vu
記憶の作り方 会話から事実を抽出して保存 観察を畳み込んで学習 書かない。既存の記録を索引
LLM 抽出に必要 既定でキー必須 不要(埋め込みのみ任意)
導入サイズ(実測) 217MB 6.8GB 21.7MB(単一バイナリ・v0.23.3)
入れた日の状態 空 空 過去ぶんが即引ける
返ってくるもの 抽出された事実 畳み込まれた観察 実在した発話そのもの
ライセンス Apache-2.0 MIT MIT

一方で、この設計には構造的な限界がある。記録に残っていないことは引けない。 エージェントが考えただけで書かなかったこと、別のマシンでやったこと、口頭で決まったことは索引に入らない。mem0 や Letta が「抽出して要約する」ことで扱おうとしている情報の一部は、原理的にこちらの守備範囲の外にある。逆に、抽出の誤りやモデル依存の揺れも原理的に起きない。どちらが優れているかではなく、何を諦めるかの選択だ。併用も理屈のうえでは成立する(片方は発話そのもの、もう片方は抽出事実を返す二階建て)が、両方をフックで自動注入すると同じ話題に別々の形の記憶が降ってくるので、まずどちらか一方で自分の履歴に効くかを確かめる順番を勧めたい。

deja-vuを試す前に押さえる点

・自分の履歴が資産になるか先に見る:deja sources で手元に何セッション・何MBあるか即分かる。薄ければ効果も薄い
・入れた日から効くのが最大の利点:育てる必要がなく、評価に1スプリント待たなくていい
・記録に無いことは出ない:抽出型の記憶とは排他でなく補完関係
・埋め込みは任意:未設定だと localhost の 11434 と 1234 を探しに行く。嫌なら DEJA_EMBED_OFF=1
・秘匿情報の扱いに注意:記録には認証情報が混ざりうる。索引前に deja secrets で点検・スクラブ。秘匿はパターン一致で未知の形は通り抜けうる
・ベンチ値は検索側の指標:97.2%はLLMの回答精度ではない。自分の用途で効くかは自分の履歴で確かめる
・動きが速い:v0.23.3 時点で main は翌日もコミットが入る。固定するならバージョンを明示する

総括。 deja-vu の賭けは「エージェントの記憶で一番価値があるのは、実はもう書かれている」という一点だ。索引するだけなのでモデルもキーもサーバーも要らず、入れた瞬間から過去が引ける。持ち込まれた数値のうち、バイナリは版で動き(現行21.7MB)、索引速度は現行13.6秒が公称で、97.2%は検索側の再現率という狭い意味だった。公称をそのまま載せるより、その意味と再現手順まで読んで伝えるほうが、この道具の評価としては正確になる。 試すコストは deja sources の1回ぶんなので、履歴が厚い人は先にそれを叩いてから判断するのが早い。

検証環境と但し書き

  • ・Linux 6.18/2026-10-31。公式リリース deja-vu_0.23.3_linux_amd64.tar.gz を取得・展開し、同梱バイナリのサイズ(21,729,442バイト)と deja 0.23.3 を実測。対応ハーネス数はソース internal/sources/registry.go を数えた(43系統)。
  • ・未検証:97.2% R@5・13.6秒・トークン半分などの公称ベンチは再実行していない(著者公称・再現手順はリポジトリに同梱)。前回 v0.21.4(2026-09-30)では合成コーパスで索引の桁と、鍵ゼロでの動作、MCP常駐の軽さを実測済み。
  • ・star 1.3k・fork 156 はリポジトリページの表示値。本記事は読者からの題材提供を受けて取り上げた。金銭等の対価は受け取っておらず、数値は独立に実測したか出典を明示して引用している。

参照ソース

・vshulcz/deja-vu(公式リポジトリ) — README・internal/sources/registry.go・go.mod・LICENSE を 2026-10-31 に確認(v0.23.3)
・deja-vu ベンチマーク — 97.2% R@5・13.6秒などの公称値の出どころと再実行手順
・LongMemEval(ベンチマークの定義元) — 公式指標 evidence_recall の出どころ