deja-vu

コーディングエージェントが、すでに解決した問題を何度もデバッグし直すことはありません。

Claude Code、Codex、Cursorをはじめとする40以上のエージェントは、すでに各セッションをディスクに保存しています。 dejaはそのすべてを数カ月分にわたってインデックス化し、今作業しているエージェントに、必要な部分を渡します。

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Português | Français | Deutsch | Русский | Türkçe | हिन्दी

_{誰も検索していません。エージェント自身がdejaを呼び出しました。合成コーパスを使った2回の実際の実行であり、個人の履歴は公開されていません。}

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

_{macOSとLinuxに対応。インストールは10秒、インデックス作成も約10秒です · Windows、Homebrew、npmなどについてはこちら}

_{deja-vuのメンテナーである私が、すべてのドライバー、コーパス、採点ルールをこのリポジトリで公開しています · 直接比較と、疑問のある行を再実行する方法 · すべての実行結果}

ドキュメント · ベンチマーク · 比較について · ツールへの組み込み方

_{役に立ったら、GitHubでdeja-vuにスターを付けてください。}

ターミナルで引数なしで deja を実行すると、すべてのエージェントの履歴を検索できます。まず未コミットの変更に関連するセッションが表示され、次にこのプロジェクトの最近のセッションが表示されます。入力するにつれて、一覧が絞り込まれます。

• ↑↓ でセッションを選択し、↵ で該当箇所を開き、n と N で一致箇所を順に移動し、esc で戻ります。セッション内では、/ で単語を検索し、] と [ で自分が質問したターン間を移動します。
• 検索ボックスではフィルターを使えます。コロン付きのエージェント名（codex:）、today、yesterday、week、month、in:<project> が使えます。
• ^s で日付の見出しごとに新しい順で検索結果を表示し、最も一致する結果順に戻します。スクリプトからは deja search --sort date で同じことができます。
• r で、そのセッションを作成したエージェントで再開します。o で別のエージェントで続行します。セッションで質問した内容、決定した内容、未解決の内容を引き継いで開始します。
• tab で、このプロジェクト、すべてのプロジェクト、Deleted を切り替えます。Deleted には、エージェントが削除したものの deja が保持しているセッションが表示されます。R で元に戻します。
• D で、確認後にエージェントと deja の両方からセッションを消去します（スクリプトからは deja delete <id>）。
• ? ですべてのキー操作を表示し、^k で残りの操作を表示します（セッション ID やプロジェクトのパスをコピーする、セッションを忘れるなど）。一覧からは q で終了します。esc で戻り、検索ボックスが空の場合は終了します。

DEJA_TUI=0 を指定すると、テキストの要約が表示されます。これは deja brief と同じです。パイプに渡すと、インデックス済みの内容と次に実行するコマンドが表示されます。

特長

• 最初からすべて利用できます。 インストール前の数か月分の履歴も、初日から検索できます。数ギガバイトのデータから deja "connection pool exhausted" で検索できます。
• すべてのエージェントで、ひとつの記憶を共有します。 Codex で見つけた修正は、Claude Code、Cursor、opencode でも見つかります。43種類のエージェントが同じインデックスを読み取ります。
• 尋ねる必要はありません。 ファイルの編集やコマンドの実行が始まる前のセッション開始時、そしてコマンドの失敗後に、関連情報を呼び出します。
• コンパクション後も利用できます。 43回以上の計測済みコンパクションで、要約は決定事項の77％とコマンドの0.2％を保持しました。残りはdejaが引き継ぎます（方法）。
• 会話だけでなく、作業もインデックス化します。 各ターンで開いたファイル、終了ステータス付きのコマンド、編集で置き換えた正確な範囲を記録します。
• 何が有効だったかを把握します。 deja promote <id> --state rejected で取り消された決定を記録すると、その後の検索結果すべてに、試されたことと却下された理由が表示されます。--state accepted でその記録を取り消せます。
• 状況の変化を知らせます。 該当する検索結果には このセッションで変更された4つのファイルが、その後変更されています と表示されます。判断できない場合は何も表示しません。
• ローカルでプライベートです。 モデルもサーバーも不要です。セマンティック検索を有効にした場合のみ、埋め込みを使用します。インデックスの作成時にキーとトークンは除去されます（プライバシー）。
• どこでも使えます。 deja sync ssh laptop でマシン間を同期でき、クラウドを経由しません。deja handoff --to codex で別のエージェントに引き継げます。
• Goの単一バイナリです。 macOS、Linux、Windowsに対応し、Homebrew、Scoop、winget、npm、または go install からインストールできます。

自分の作業をカードに

deja stats --card でターミナルに表示できます。ファイル名を指定すると、プロフィールのREADME用にSVGを書き出します。ほかの場所に投稿する場合は、PNGに変換してください。このページでは、お使いのブラウザー内で変換できます。

すべての機能については、ドキュメントをご覧ください。

インストール

macOSとLinuxでは、冒頭の2つのコマンドだけでインストールできます。

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の履歴検索機能を組み込み、対応しているエージェントではセッション開始時の履歴検索を有効にし、最初のインデックスを作成します。これにより、次のセッションでその分の時間がかかりません。

新しいエージェントのセッションを開始し、数か月前に取り組んだことについて質問してみてください。

JWTのリフレッシュトークンのローテーションに以前取り組んだことはありますか？履歴を確認してください

わざわざ質問する必要もありません。自動履歴検索を有効にしておけば、セッション開始時にエージェントはそのプロジェクトで解決したことをすでに把握しています。自分で確認するには、deja を実行してください。

claude plugin marketplace add vshulcz/deja-vu && claude plugin install deja-vu@deja-vu

scoop install deja-vu
winget install vshulcz.deja-vu

プライバシー

インデックス作成と検索はローカルで行われます。ネットワークを使用するのは deja update、deja sync ssh、deja doctor でのバージョン確認、設定したエンドポイントに対する deja embed（セマンティック用サイドカーの構築後は、各検索でもクエリをそのエンドポイントに送信します）、および対話型コマンドの実行時に1日1回行う最新リリースの確認のみです。この確認でセッションデータが送信されることはありません。DEJA_OFFLINE=1 を設定すると確認が無効になり、DEJA_NO_UPDATE_NOTICE に任意の値を設定した場合も無効になります。後者は、新バージョンの初回実行時に表示される通知も非表示にします。

インデックス作成時に認証情報を除去します。対象はクラウドおよびプロバイダーのキー、トークン、JWT、PEMブロック、URL内または文章で記述されたパスワードです。それぞれ [redacted:<kind>] に置き換えられ、周囲のテキストは引き続き検索できます。元のトランスクリプトには認証情報が残ります（あるマシンでは42セッションに84件ありました）。deja secrets は値を表示せずに該当するセッション名を表示し、deja secrets --scrub は可能なものを書き換え、元のファイルをその隣に保持します。

deja forget はセッションを削除し、再構築後も削除状態を維持します。~/.config/deja/exclude では、1行につき1つのプロジェクトを除外できます。また、harness:opencode のように指定してストア全体を除外できます。セキュリティモデルには、データの流れと、リダクションで検出できないものについて記載されています。

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

履歴に質問する

クエリの先頭の単語が 4 文字以上で、コマンド名と 1 文字違いの場合、deja はそのコマンドを標準エラー出力に表示してから、通常どおり検索します。候補の表示を省略するには、deja search <query> を使用します。

MCP ツール

サーバーが公開するツールはmodeを指定するdejaの1つだけで、deja installで組み込めます。1ターンあたりのツール定義のコストは477トークンです。day zeroで測定した7つのサーバーのうち、最も大きいものでは8,283トークンかかります。以前の6つのツール名（recall、recall_context、blame、fix、how、remember）も引き続き応答します。deja mcp --context-searchは、Qwen CodeのExternal Context MCP Profile v1用の、単一のcontext_searchツールを備えた別のサーバーです（Qwenのページ）。

対応ハーネス

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。

TRAE IDE は接続されていますが、読み取りには対応していません。チャットは暗号化されたデータベースに保存されています。deja install trae-ide を実行すると MCP サーバーとスキルが追加され、trae-ide-auto を実行するとフックが追加されます。TRAE IDE がフックを実行するのは、Settings > Hooks で有効にした後だけです。

カスタムのストア場所は DEJA_*_ROOT 変数で指定でき、各エージェント固有の移動先指定変数も尊重されます。 セッション形式レジストリには、ハーネスごとに観測されたパス、レコードのスキーマ、ロールのマッピングが記載されています。また、合成フィクスチャによって、これらの説明がパーサーに対して常に検証されています。

独自のパッケージを持つハーネス

deja install --auto を実行すると、他のすべてのハーネスと同じように、これらも自動で設定されます。これが引き続き最短の方法です。また、CLI からではなく、それぞれのエコシステムで拡張機能をインストールする人向けに、独自のパッケージも用意されています。

どちらの方法も単独で使えます。両方を使っても機能が二重になることはありません。各パッケージは、deja install がすでに書き込んだ内容を読み取り、すでにお使いの deja を利用します。

Spec Kit プロジェクトでは、拡張機能によって /speckit.deja-vu.recall が追加され、実装前に過去のセッションを検索して、その機能について調べられます。

specify extension add deja-vu --from https://github.com/vshulcz/deja-vu/releases/latest/download/deja-spec-kit.zip

同じ検索機能は、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

export DEJA_EMBED_URL='https://example.com/v1/embeddings'
export DEJA_EMBED_MODEL='embedding-model'
export DEJA_EMBED_KEY='...'
deja embed

export DEJA_EMBED_MODEL='multilingual-e5-small'
export DEJA_EMBED_QUERY_PREFIX='query: '
export DEJA_EMBED_PASSAGE_PREFIX='passage: '
deja embed

検索はミリ秒単位です。LongMemEval-S では、クリーンアップ済みの470問のデータセットで hit@1 が88.1％、全500問では hit@1 が87.4％です。LoCoMo の検索では hit@1 が70.5％です。このマシンがすでに解決済みのタスクでは、トークン数を58％削減しました。各方式を11回実行し、何も接続していない場合は53,558対126,222トークン、後のビルドで方式を交互に実行した場合は52,815対103,443トークンでした。どちらの検索ハーネスもこのリポジトリに含まれており、公開データセットで数分以内に実行できます：ベンチマーク · 1つのタスクにかかるコスト。

その他の測定結果は deja bench で確認できます。

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

仕組み

~/.cache/deja にローカルの転置インデックスを作成します。JSONL と SQLite のストアを解析し、認証情報を伏せたうえで、追記専用の records.bin とトークンバケットを書き込み、ファイルごとの状態を manifest.gob で追跡します。そのため、以降の実行では変更分だけを取り込みます。MCP サーバー、統計、共有、同期はすべてこのインデックスを読み取ります。詳細はdocs/ARCHITECTURE.mdをご覧ください。

よくある質問

~/work/monorepo = work
~/work/worktrees = work

deja uninstall --all
rm -rf ~/.cache/deja ~/.local/share/deja ~/.config/deja

ガイド

機能ではなく、状況に合わせて書かれています。

• エージェントは過去の会話を覚えていますか？ — 各エージェントがセッション間で保持するものと、破棄するもの
• ディスク上のセッションファイル — ~/.claude/projects がどれほど大きくなるか、削除すると何が失われるか
• エージェントがこれまでのコンテキストを失った — クラッシュ後、クリア後、または空の状態で再開したセッションについて
• コンテキストウィンドウがいっぱいです — コンパクションで何が保持されるか、測定結果、代わりにすべきこと
• 昨日のセッションを再開する — すべてのエージェントからセッションを探し、それを所有するエージェントで再開する
• エージェントがすでに修正したミスを繰り返す
• 解決したセッションを見つける
• エージェントがセッション間で忘れてしまう理由 · 各エージェントが履歴を保存する場所
• 削除した Claude Code セッションを復元する · Claude Code：セッション ID の会話が見つかりません · Codex セッションの再開 · 古い Claude Code セッションを削除する
• 各メモリーツールをインストールした時点で把握していること · メモリープラグインの比較
• コンパクションで破棄されるもの · エージェントの切り替え · エージェントの監査 · 会話のエクスポート · 複数のマシン間で · メモリーにかかるコスト ハーネス別：Claude Code · Codex · Cursor · Windsurf · opencode · DeepSeek Harness · Kimi Code · Zed · Grok Build · Gemini CLI · Qwen Code · OpenClaw · Goose · Cline · pi · Hermes · Copilot CLI · Copilot Chat · aider · Amp · Antigravity · Continue · Crush · Roo Code · Kilo Code · Kiro · Cherry Studio · Oh My Pi · prime-agent · Senpi · Kimchi · Command Code · ZCode · gjc · CodeWhale · Reasonix

自分の履歴で試す

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

インストールは10秒、インデックス作成も約10秒です。エージェントが次のセッションを開始すると、そのプロジェクトで解決したことをすでに把握しています。このツールをインストールする前の内容もすべて含まれます。

コントリビューション

make build test lintを実行してから、CONTRIBUTING.mdをご覧ください。ハーネスの追加はパーサーレジストリから始めます。優先事項と対象外事項はROADMAP.mdに記載されています。初めて取り組むのに適したIssueにはラベルが付いています。

サポート

バグや質問はissuesへお寄せください。悪用可能と思われる問題は、代わりにSECURITY.mdにある非公開のアドバイザリーリンクからご報告ください。dejaが読み取る内容、外部に送信しない内容、プロジェクトの除外方法やセッションの削除方法については、プライバシーをご覧ください。

ライセンス

MIT © Vladislav Shulcz