Show HN: Recall – Claude Codeのための完全ローカルなプロジェクト記憶機能
Show HN: Recall – fully-local project memory for Claude Code (github.com)
要約
Recallは、Claude Codeのセッションごとにプロジェクトの記憶をローカルに保持し、要約を生成するツールです。APIキーや外部モデルなしで完全にオフラインで動作し、各セッションでのプロジェクトの再説明が不要になるため、Claude Codeの「コールドスタート」問題を解決します。プライバシーを重視し、機密データが外部に送信されることなく、TF-IDFとTextRankによる抽出要約でコスト効率良く記憶を管理します。
全文翻訳
🔁
Recall — Claude Code 用の完全ローカルなプロジェクトメモリ
[画像: Claude Code 用に構築] [画像: OpenCode: オプトインサポート] [画像: CI] [画像: CodeQL] [画像: Coverage] [画像: License: MIT]
Claude Code は、セッションごとにゼロから開始します。Recall はセッションのローカルログを保持し、それを要約して、完全にマシン上で要約可能な状態にします。APIキー不要、外部モデル不要、どこにも送信されません。これは、Claude Code をローカルでサブスクリプションで実行しているユーザー向けに構築されています。ループ内の唯一のAIは Claude Code 自体であり、要約は古典的な Python 要約ツールによって行われます。
Recall の理由
- サブスクリプションで無料。 コールドスタート問題を解決します — セッションごとにプロジェクトを再説明する必要がなくなり、従量課金制の要約ツールが請求額を増やすこともありません。要約はローカルアルゴリズムであり、LLMの呼び出しではないため、永続的なメモリコストは、すでに支払っているサブスクリプション以上の費用はかかりません。
- 利用クレジットを節約します。 2つの方法があります。(1) 要約はローカルで構築されるため、メモリのキャプチャと更新にはモデルトークンをゼロ消費します。(2) 各セッションでプロジェクトをゼロから説明し直すのではなく、コンパクトな
context.md(約1〜2Kトークン)から再開することで、セッションあたりのトークン消費が大幅に少なくなり、サブスクリプションの利用制限を延長できます(または、APIでは請求クレジットを削減できます)。 - 何もマシンから離れません。 トランスクリプト(コード、パス、場合によってはシークレット)は、いかなるAPIにも送信されません。「メモリ」ツールの大半はコンテキストをモデルエンドポイントにパイプしますが、Recall は彼らができないプライバシー保証を提供します。完全なポリシーについては、PRIVACY.md を参照してください。
- ゼロ摩擦。
pip install不要、ローカルモデルの実行不要、キーの設定不要、オフラインで動作します。プラグインがロードされた瞬間から機能します。
プロジェクト内に .recall/ として書き込まれる2つのファイルがあります。
history.md— ログ。 追記専用。セッションごとに、発生したとおり(プロンプト、Claude の応答、触れられたファイル、実行されたコマンド)キャプチャされます。context.md— 要約。 ローカル要約ツールによって上書きされます — 次のセッションにロードする、コンパクトな「現在地」です:目標、要約、次のステップ/未解決のスレッド、触れられたファイル、およびどこで中断したか。
"Claude Code にはすでにメモリ機能があるのでは?"
あります — Recall は補完的なものであり、置き換えではありません。組み込みオプションは異なる問題を解決します。
CLAUDE.md(および#ショートカット) は手書きのメモリです:あなたがキュレートしたルールとメモを、Claude が従う指示としてロードします。「どのように作業してほしいか」には最適ですが、手動での維持が必要で、セッションで実際に何が起こったかを記録しません。--continue/--resumeは以前の会話を再生します — 完全な忠実度ですが、トランスクリプト全体を再ロードします(トークンを大量消費)し、1台のマシン上のローカルセッション履歴に紐づいており、ポータブルで読みやすい要約ではありません。- コンテキストの圧縮は、セッション内の会話を圧縮します。数日後に再オープンできる永続的な記録ではありません。
Recall はこれらの間のギャップを埋めます:各セッションが何を行ったかの自動的で決定論的な記録を、コンパクトな再開ポイントに圧縮します。
CLAUDE.md / # | --continue / --resume | Recall | |
|---|---|---|---|
| 何か | 手書きのメモとルール | 前の会話を再ロード | 自動キャプチャされたセッションログ + ローカル要約 |
| 維持 | 手動 | なし(セッションを選択) | なし — 作業中に書き込まれる |
| 保持 | 従うべき指示 | 完全な前のトランスクリプト | 目標、ファイル、コマンド、中断した場所、次のステップ |
| 再開コスト | 小 | 大(完全なトランスクリプトを再生) | 約1〜2Kトークン(コンパクトな要約) |
| 形式 | Markdown(編集可能) | ローカルセッション状態 | .recall/ 内のプレーンテキスト — diff可能&共有可能 |
| Claude の扱い | 指示として | 会話として | 信頼できない参照データとして囲まれる |
要するに:CLAUDE.md はどのように作業してほしいか、Recall は前回何をして、どこで止まったか — オフラインで、モデルトークンを消費せずに生成されます。
仕組み
| モーメント | 何が起こるか |
|---|---|
| セッション中 | Stop / SessionEnd フックが .recall/history.md に新しいアクティビティを追記します。キャプチャは増分的(新しいターンのみ)で、完全にローカルです。 |
| セッション開始時 | SessionStart フックが context.md を表示し、Claude があなたに2つのことを尋ねます:保存されたコンテキストから再開しますか?このセッションのログを続けますか? |
| 終了前 | /recall:save を実行します。ローカル要約ツールが history.md を読み込み、context.md を(上書き)生成します。 |
| …または自動的に | auto_save_context: "on_end" を設定すると、セッションが終了するたびに context.md が再生成されます — /recall:save は不要です。 |
ネットワーク呼び出しは一切ありません — 要約はローカルで実行される TF-IDF + TextRank(抽出型要約)によって生成されます。
要約ツール
scripts/summarizer.py はセッションの最も中心的な文をランク付けします。
- TF-IDF 文ベクトル
- 文間のコサイン類似度グラフ
- TextRank — そのグラフ上での PageRank のべき乗反復 — で文をスコアリング
- 上位 N 個を元の順序で保持
context.md は、トランスクリプトと git から直接取得した決定論的な事実でその要約をラップします:目標(最初の質問)、触れられたファイル、実行されたコマンド、中断した場所、および git diff --stat。
インストール不要。 TF-IDF + TextRank の実装全体は summarizer.py にバンドルされています。numpy がインポート可能であれば、数学をベクトル化するために使用されます(大きなセッションでは高速)。そうでなければ、同一の純粋 Python TextRank が実行されます。同じアルゴリズム、同じ結果 — numpy はオプションのアクセラレータであり、必須ではありません。保存出力は、どのパスが実行されたかを示します。
コマンド
/recall:save— ローカル要約ツールを実行 →context.mdを(上書き)生成。/recall:show—context.mdを表示。/recall:log—history.mdの末尾を表示。
設定 — recall.config.json
プロジェクトルートにこれをドロップしてデフォルトを上書きします。
| キー | デフォルト | 目的 |
|---|---|---|
output_dir | ".recall" | history.md / context.md の場所。 |
capture_history | true | セッションアクティビティを history.md に追記します。 |
auto_save_context | "off" | セッション終了時に context.md を再生成します:"off" または "on_end"。 |
summary_sentences | 8 | 要約が保持する文の数。 |
redact | true | md ファイルに書き込む前に、明白なシークレットを削除します。 |
include_git | true | git diff --stat + 最近のコミットを context.md に追加します。 |
max_input_chars | 200000 | 要約ツールに渡されるテキストの最大値(古いものがドロップされます)。 |
設定を編集せずにプロジェクトのログを一時停止するには、.recall/.capture-paused を作成します。再開するには削除します。
プライバシーとセキュリティ
Recall はネットワーク呼び出しを行わず、APIキーを使用せず、サードパーティモデルをロードしません。要約ツールはローカルPythonであり、フックは標準ライブラリのみです(numpyはオプションのアクセラレータとして使用されます)。セッショントランスクリプトを読み取り、output_dir の下のみに書き込みます。具体的には:
- 認証情報 nunca。 プラグインは API キー、認証、
ANTHROPIC_*、または HTTP への参照を一切持ちません。claude自体が *