agent-session-search

エージェントセッション検索

ローカルのコーディングエージェントの履歴をインデックス化して検索する、統合型の CLI／TUI です。13 種類以上のエージェントのセッションを単一の検索可能なインデックスに集約し、60 ミリ秒未満のレイテンシーを実現します。ロボットモードと柔軟な構文を備え、AI エージェントでの利用に特化して設計されています。ライブラリではありません。CASS は別途インストールが必要な外部の Rust CLI です。

リアルタイムのセッション監視には使用しないでください。エージェントのローカルセッション履歴がディスクに保存されていない場合にも使用しないでください。

curl のワンライナー、Homebrew、または Scoop でインストールできます（設定リファレンスを参照）。ソースからビルドするには、Rust nightly ツールチェーンが必要です。

重要：cass を引数なしで実行しないでください。セッションをブロックする対話型 TUI が起動します。必ず --robot または --json フラグを使用してください。

基本的なコマンド

コマンド	用途
cass health --json	ヘルスチェック（終了コード 0 = 正常、0 以外 = 異常）
cass index --full	DB と検索インデックスを完全に再構築します
cass index	前回のスキャン以降の差分を更新します
cass index --watch	監視モード：ファイルの変更時に自動で再インデックスします
cass search "query" --robot	JSON 出力で検索します
cass search "query" --robot --fields minimal	最小限のペイロード（パス、行、エージェント）
cass search "query" --robot --limit 5	結果数を制限します
cass search "query" --robot --mode hybrid	ハイブリッド検索（語彙検索＋セマンティック検索）を使用します
cass view /path -n 42 --json	指定した行のソースを表示します
cass expand /path -n 42 -C 5 --json	検索結果の前後のコンテキストを表示します
cass export-html /path	会話を自己完結型の HTML としてエクスポートします
cass robot-docs guide	LLM に最適化されたドキュメント
cass robot-docs schemas	応答の JSON スキーマ
cass sources setup	複数マシンのリモートソースを設定します

対応エージェント

エージェント	保存場所	形式
Claude Code	~/.claude/projects	JSONL
Codex	~/.codex/sessions	Rollout JSONL
Gemini CLI	~/.gemini/tmp	JSON
Cline	VS Code のグローバルストレージ	タスクディレクトリ
OpenCode	.opencode ディレクトリ	SQLite
Amp	~/.local/share/amp + VS Code	混在
Cursor	~/Library/Application Support/Cursor/User/	SQLite state.vscdb
ChatGPT	~/Library/Application Support/com.openai.chat	JSON（v1 は暗号化なし、v2/v3 は暗号化）
Aider	~/.aider.chat.history.md + プロジェクトごと	Markdown
Pi-Agent	~/.pi/agent/sessions	JSONL
Factory (Droid)	~/.factory/sessions	JSONL
Clawdbot	~/.clawdbot/sessions	JSONL
Vibe (Mistral)	~/.vibe/logs/session/*/messages.jsonl	JSONL

検索モード

モード	アルゴリズム	最適な用途
lexical（デフォルト）	Tantivy による BM25 全文検索	正確な用語の照合、コード検索
semantic	ベクトル類似度（FastEmbed 経由の MiniLM）	概念的なクエリ、類似項目の検索
hybrid	Reciprocal Rank Fusion（RRF）	適合率と再現率のバランス

セマンティックモードには MiniLM のモデルファイルが必要です。利用できない場合、CASS は近似類似度を求めるためにハッシュベースの埋め込み器にフォールバックします。

寛容な構文

CASS はエージェントによくある誤りを自動修正し、stderr に学習用のメモを出力します。

入力	修正
コマンドのタイプミス	Levenshtein 距離で正規のコマンドに照合
単一ダッシュの長いフラグ（-robot）	--robot に正規化
大文字・小文字の誤り（--Robot）	小文字の --robot に変換

よくある間違い

間違い	修正
cass を引数なしで実行する	常に --robot または --json を使用します
--robot フラグがない	JSON を出力するには --robot を追加します
インデックスが存在しない	まず cass index --full を実行します
トークン予算の超過	--fields minimal と --limit を使用します
古い検索結果	cass index を実行して更新します
stderr を JSON として解析する	stdout は JSON のみで、診断情報は stderr に出力されます
CASS がインストール済みだと思い込む	まず cass health --json を確認します

委任

CASS CLI を介してコーディングエージェントのセッション履歴をインデックス化、検索、分析するには、このスキルを使用します。すべての操作は外部の cass バイナリに委任されます。インストール済みバージョンの正式なコマンドリファレンスを直接確認するには、cass robot-docs guide を実行してください。

複数マシンのセッションを検索する方法については、「リモートソース」を参照してください。人間のオペレーターによる TUI の使用方法については、「TUI リファレンス」を参照してください。

参考資料

• コマンドリファレンス -- インデックス作成、検索、セッションの表示、エクスポート、診断
• ロボットモード -- 自己文書化 API、柔軟な構文、出力形式、トークン予算
• クエリ言語 -- ブール演算子、ワイルドカード、一致タイプ、時間形式、自動あいまい検索へのフォールバック
• 検索とランキング -- 検索モード、ランキング、スコアリング式
• リモートソース -- SSH/rsync による複数マシンの検索、セットアップウィザード、パスマッピング
• TUI リファレンス -- キーボードショートカット、テーマ、保存済みビュー、表示密度モード、ブックマーク
• エラー処理 -- 構造化エラー、終了コード、トラブルシューティング
• 内部仕様 -- レスポンス形式、重複排除、パフォーマンス、監視モード、セマンティック検索
• 設定 -- 環境変数、シェル補完、インストール、統合