mcpField
S
session-index

session-index

github.com/lee-fuhrエージェントワークフロー3177 回インストール38 週間前に更新
リポジトリ

session-index について

Claude Code のセッションを格納した SQLite インデックスを検索・分析する Agent Skill です。過去の会話や文脈を調べ、以前の試行内容をまとめられます。

主な機能

  1. 01セッションの全文検索
  2. 02一致した会話文脈の取得
  3. 03クライアント・ツール・プロジェクト・日付での絞り込み
  4. 04作業時間とツール使用状況の分析
  5. 05複数セッションの内容整理

活用シーン

  1. 01特定の話題に関する過去の会話を探す
  2. 02以前のセッションで試した方法を確認する
  3. 03クライアント別の時間やツール使用状況を調べる

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/lee-fuhr/claude-session-index --skill session-index

インストール後、Claude Code で/session-indexを入力して読み込まれたか確認します。

詳細

セッションインデックススキル

あなたはセッションインデックスにアクセスできます — これはすべての Claude Code セッションを横断して FTS5 全文検索ができる SQLite データベースです。ユーザーが過去のセッションや以前の会話について尋ねたり、以前に何を試したかを知りたがったりしたときはいつでも、これを使用してください。

ユーザーのインターフェースはこの会話です。 ユーザーは自然に質問し（「最近ブラウザ操作について話さなかったっけ？」）、あなたがそれを CLI コマンドに変換し、結果を会話形式で提示します。ユーザーが CLI の構文を知る必要は一切ありません。

セッションクエリの処理方法

1. 質問からキーワードを抽出する

ユーザーが言う: 「最近ブラウザ操作について話さなかったっけ？」 あなたが検索する: sessions "browser control"

ユーザーが言う: 「フォーム自動化のためにどんなアプローチを試したっけ？」 あなたが検索する: sessions "form automation"

ユーザーが言う: 「今週 Acme にどれくらい時間を使った？」 あなたが実行する: sessions analytics --client "Acme" --week

2. Bash 経由で適切なコマンドを実行する

検索 — トピックでセッションを探す:

sessions "relevant keywords"
sessions "relevant keywords" --context    # includes conversation excerpts

コンテキスト — セッションから実際の会話を読み取る:

sessions context <session_id> "search term"   # exchanges matching a term
sessions context <session_id>                 # all exchanges

分析 — 作業量、時間、ツールの使用状況:

sessions analytics                    # overall
sessions analytics --client "Acme"    # per client
sessions analytics --week             # this week
sessions analytics --month            # this month

フィルター — メタデータでセッションを探す:

sessions find --client "Acme"              # by client
sessions find --tool Task --week           # by tool + date
sessions find --project myapp              # by project
sessions recent 20                         # last N sessions
3. 統合の場合（「何がうまくいった？」「何を試した？」）

これは最も価値のある機能です。ユーザーが複数のセッションにまたがる質問をしたとき:

  1. 検索: sessions "topic" -n 10
  2. 上位 3〜5 件の結果について、コンテキストを抽出: sessions context <id> "topic" -n 3
  3. model="haiku" を指定して Task を起動し、統合する:
    • どのようなアプローチが試されたか？
    • 何がうまくいき、何が失敗したか？
    • 繰り返し現れるパターンは？
    • 現在の状態は？
  4. 各ソースセッションへの claude --resume <id> リンクを添えて、統合結果を会話形式で提示する

これはセッション内の Haiku サブエージェントを使用します — 外部 API キーは不要です。

4. 結果を会話形式で提示する

生の CLI 出力をそのまま出さないでください。要約してください:

  • 「先週 3 つのセッションでブラウザ操作について話しました...」
  • 「うまくいった主なアプローチは...」
  • ユーザーがすぐに戻れるように claude --resume <session_id> リンクを含める
  • コンテキストが関連する場合は、重要なやり取りを引用する

インストール

pip install claude-session-index

いずれかのコマンドを初めて実行すると、既存のすべてのセッションが自動的にインデックス化されます。

データの場所

  • データベース: ~/.session-index/sessions.db
  • トピック: ~/.claude/session-topics/
  • 設定: ~/.session-index/config.json（任意）

コメント

Markdown 対応