mcpField
S
session-finder

session-finder

github.com/glebisエージェントワークフロー401162 回インストール1 日前に更新
リポジトリ

session-finder について

session-finderはGeminiの埋め込みを使い、Claude Codeのセッションを意味検索します。セッション名だけに頼らず、クエリから過去のセッションを見つけて再開できます。

主な機能

  1. 01Claude Codeセッションのインデックス作成
  2. 02意味的な類似度によるセッション検索
  3. 03最も一致するセッションを開く
  4. 04インデックス統計の表示
  5. 05セッション要約とツール使用状況の抽出

活用シーン

  1. 01タスクの説明から過去のセッションを検索
  2. 02プロジェクトや作業パターンに関するセッションを特定
  3. 03Claude Codeで関連セッションを再開

インストール

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

$npx skills add https://github.com/glebis/claude-skills --skill session-finder

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

同梱ファイル.claude-plugin/plugin.jsonscripts/session_finder.py

詳細

セッションファインダー

Gemini の埋め込みを使用した、Claude Code セッションのセマンティック検索です。

コマンド

セッションをインデックス化
python3 ~/.claude/skills/session-finder/scripts/session_finder.py index [--max-age-days 90]
検索
python3 ~/.claude/skills/session-finder/scripts/session_finder.py search "query" [--top 5]
最適な検索結果を直接開く
python3 ~/.claude/skills/session-finder/scripts/session_finder.py open "query"
統計情報
python3 ~/.claude/skills/session-finder/scripts/session_finder.py stats

仕組み

  1. ドキュメントの抽出 — LLM は使用しません。各セッションの JSONL を解析し、構造化ドキュメントに変換します。
    • 利用可能な場合は away_summary イベント（既存の Claude による要約）
    • 最初のユーザーメッセージ（タスクの説明）
    • 後続のユーザーメッセージ（簡潔にまとめたもの）
    • 最初のアシスタントの応答
    • 使用したツール
    • プロジェクト名
  2. 埋め込み — llm CLI 経由で gemini-embedding-exp-03-07 を使ってドキュメントを埋め込みます
  3. 保存 — ~/.claude/session-finder.db に SQLite で保存します
  4. 検索 — クエリを埋め込み、コサイン類似度で全セッションをランク付けします。デフォルトで、最上位の検索結果を開きます

ワークフロー

ユーザーからセッションの検索を依頼された場合：

  1. クエリを指定して search を実行します
  2. 信頼度スコアとともに検索結果を提示します
  3. claude --resume <id> で最上位の検索結果を再開するか確認します

コメント

Markdown 対応