raiyanyahya/recall

解決する課題

Recallは、Claude CodeなどのAIコーディングエージェントにおける「コールドスタート」問題に対処します。新しいセッションが開始されるたびに、以前の作業の記憶が失われる状況を解消します。セッション開始時にプロジェクトの目的や進行状況、未解決の課題を手動で再説明する必要がなくなり、外部のLLMにセッション履歴を送信して要約する際の高コストやプライバシーのリスクも回避できます。

動作方法

Recallは.recall/ディレクトリ内に2つのローカルMarkdownファイルを維持します：

• history.md：セッション中に発生したすべてのプロンプト、返信、ファイル変更、コマンド実行を追加のみ可能なログ。
• context.md：プロジェクトの現在の状態を要約したファイルで、目標、変更されたファイル、次に取り組むべきステップを含みます。

LLMではなく、TF-IDFとTextRankに基づく古典的なローカルPython要約アルゴリズムを使用して、履歴から最も中心的な文を抽出し、要約を生成します。この処理はユーザーのマシン上で完全にローカルで行われ、APIキーもネットワーク接続も不要です。

対象ユーザー

Claude CodeやOpenCodeを使用している開発者で、複数のセッションにわたってプロジェクト記憶を永続的に保持したい、プライバシーを守りつつコストを抑えた方法を探している人。

特徴

• トークンコストゼロ：要約処理はLLM呼び出しではなくローカルアルゴリズムで行われるため、使用クレジットを節約できます。
• 完全にローカルでプライベート：データはマシン外に送信されません。トランスクリプトと要約はすべてローカルに保存され、外部APIに送信されることはありません。
• 摩擦ゼロ：複雑なインストールやローカルモデルの設定は不要。要約アルゴリズムはバンドル済みで、標準Pythonライブラリを使用しています。
• エージェントに依存しない：Claude Code向けに開発されていますが、OpenCodeなどの他のエージェントとも統合可能。記憶はプレーンなMarkdownで保存されるためです。