Show HN: Agent-historian – AIエージェントが自身の過去セッションを検索できるようにする
Agent-historian は、AIコーディングエージェントがコマンドラインから過去のセッション履歴を検索し、以前の研究、コマンド、エラー、決定を復元して重複作業を避けるためのオープンソースツールです。OpenCode や Claude Code など複数のエージェントをサポートし、読み取り専用、プログレッシブディスクロージャー、ゼロランタイム依存性を備えています。メモリレイヤーやRAGを補完し、正確な原文を提供します。
Agent-historian は、AIコーディングエージェントがセッションをまたいで状態を持たないという問題を解決する新しいオープンソースツールです。新しいチャットのたびにエージェントはゼロから始まり、同じファイルの読み取り、同じコマンドの実行、同じ結論の導出を繰り返し、時間とトークンを無駄にします。このツールは ochist というシンプルなCLIとAgent Skillを提供し、エージェントが過去のセッション記録を検索・読み取りできるようにします。
現在、OpenCode(opencode.db)と Claude Code(~/.claude/projects/*.jsonl)をサポートし、拡張可能です。検索範囲はデフォルトで現在のプロジェクト(カレントディレクトリ以下)ですが、--global で全プロジェクトに広げられます。すべての操作は読み取り専用で、データストアを変更しません。出力はパイプに適した形式で、grep/head/wc/jq と組み合わせて使い、セッション全体をコンテキストにダンプするのを避けます。
メモリレイヤー(mem0など)の要約記憶やRAGの意味検索とは異なり、agent-historian はディスク上の生のセッションテキストを直接読み取り、プログレッシブディスクロージャー(位置特定→方向付け→スキャン→読み取り)を使用して関連行のみをコンテキストウィンドウに取り込みます。これにより情報の正確性と損失ゼロが保証されます。
プロジェクトには実際のマージ競合解決例が含まれています。エージェントが go.sum の競合を正しく解決するコマンドを忘れたとき、履歴セッションを確認することで以前のコマンドを見つけ、手動編集の間違いを避けました。著者は、メモリレイヤーではこの詳細を捕捉できなかったと指摘します。なぜなら、明示的に記憶するよう指示されたものだけが保存されるのに対し、セッションログにはすべてのコマンドと出力が常に含まれているからです。
Agent-historian がCLI+Skillを採用し、MCPサーバーでない理由は次の通りです。エージェントは既にシェルを持っており、CLIを使えばエージェント自身が ochist grep … | head のようにコマンドを組み合わせられます。MCPはすべてのツールパラメータをハードコードする必要があります。コンテキスト制御はエージェントにあり、ゼロ常駐オーバーヘッド、Skillが「研究前に履歴を確認する」ワークフローをエンコードし、移植可能で検査可能です。
インストールは簡単です。npm install -g agent-historian で ochist コマンドが使えるようになり、npx agent-historian sources で直接実行も可能です。Agent Skill は npx skills add adlternative/agent-historian -g で複数のエージェントにインストールできます。プロジェクトは、将来エージェント自体が同様の機能をネイティブに提供することを期待しており、その時はこのプロジェクトは不要になりますが、それまでは統一された読み取り専用のクロスエージェント履歴検索手段を提供します。