session-scout

Session Scout

ステータス：本番利用可能 最終更新日：2026-02-13 依存関係：PowerShell 7+（Windows）または Bash 4+（macOS/Linux）

スクリプトパスの解決：Claude Code がこのファイルを読み込む際、完全なパスが渡されます。以下の scripts/ への参照はすべて、このファイルがあるディレクトリからの相対パスです。このファイルのパスから SKILL_DIR を導出し、スクリプトの実行時に先頭に付加してください。

---

クイックスタート（1 分）

1. スクリプトを実行する

macOS / Linux：

# Show recent sessions (default: top 12)
scripts/session-scout.sh

# Show more sessions
scripts/session-scout.sh --top 20

Windows（PowerShell）：

# Show recent sessions (default: top 12)
pwsh -ExecutionPolicy Bypass -File scripts/Session-Scout.ps1

# Show more sessions
pwsh -ExecutionPolicy Bypass -File scripts/Session-Scout.ps1 -Top 20

出力列：

• Tool - Claude Code（Windows/WSL）、Claude Desktop、OpenCode CLI/Desktop
• When - 最終アクティビティのタイムスタンプ
• ProjectPath - 作業ディレクトリのパス
• Project - プロジェクトのスラッグ／識別子
• SessionId - UUID（Claude Code）またはタイムスタンプ（OpenCode）

2. CSV にエクスポートする

macOS / Linux：

# Export to default location (~/.admin/logs/session-scout-YYYY-MM-DD.csv)
scripts/session-scout.sh --csv

# Export to custom path
scripts/session-scout.sh --file ~/exports/sessions.csv

Windows（PowerShell）：

# Export to default location (~/.admin/logs/session-scout-YYYY-MM-DD.csv)
pwsh -ExecutionPolicy Bypass -File scripts/Session-Scout.ps1 -Csv

# Export to custom path
pwsh -ExecutionPolicy Bypass -File scripts/Session-Scout.ps1 -File "D:\exports\sessions.csv"

---

検出対象

Claude Code のセッション

• Windows：%USERPROFILE%\.claude\projects\*\*.jsonl
• WSL/Linux：~/.claude/projects/*/*.jsonl
• macOS：~/.claude/projects/*/*.jsonl
• 抽出する情報：cwd、プロジェクトのスラッグ、セッション UUID

Claude Desktop のセッション

• Windows：%APPDATA%\Claude および %LOCALAPPDATA%\Claude
• macOS：~/Library/Application Support/Claude/ および ~/Library/Application Support/Anthropic/
• Linux：~/.config/Claude/ および ~/.config/Anthropic/
• 検索対象：チャット、会話、トランスクリプト、履歴ファイル

OpenCode のセッション

• Windows：%USERPROFILE%\.local\share\opencode\log\*.log
• macOS/Linux：~/.local/share/opencode/log/*.log
• デスクトップ（複数ディレクトリ）と CLI（単一ディレクトリ）を区別します

---

重要なルール

必ず行うこと

• Windows：Windows PowerShell 5.1 ではなく、pwsh（PowerShell 7+）で実行してください
• Windows：直接実行する場合は -ExecutionPolicy Bypass を使用してください
• macOS/Linux：session-scout.sh を使用してください（連想配列には Bash 4+ が必要です）
• WSL のセッションが見つからない場合は、WSL が実行中であることを確認してください（Windows のみ）

絶対に行わないこと

• セッションの .jsonl ファイルを直接変更しないでください
• すべてのセッションからパスを抽出できるとは限りません（一部は空欄になる場合があります）
• WSL 内から PowerShell スクリプトを実行しないでください（代わりに Bash スクリプトを使用してください）

---

既知の問題の予防

このスキルは、記録されている 3 件の問題を予防します。

問題 #1：UUID ベースのファイル名が見つからない

エラー：Claude Code を使用中なのに、セッションが見つからない 原因：Claude Code のファイル名が chat_*.jsonl から UUID ベースに変更されたため 予防策：スクリプトは *.jsonl パターンを使用します（agent-*.jsonl は除外）

問題 #2：WSL ディストリビューション名に Null バイトが含まれる

エラー：WSL のセッションが検出されず、ディストリビューション名が U b u n t u と表示される 原因：wsl.exe -l -q が Null バイトを含む UTF-16LE を出力するため 予防策：Get-WSLDistros 関数が Null バイトを適切に取り除きます

問題 #3：OpenCode Desktop と CLI の混同

エラー：すべての OpenCode セッションが同じ種類として表示される 原因：デスクトップは複数のプロジェクトを開き、CLI は 1 つのプロジェクトを開くため 予防策：スクリプトはパターンを検出します。複数のディレクトリならデスクトップ、単一のディレクトリなら CLI です

---

パラメーターのリファレンス

PowerShell（Session-Scout.ps1）：

パラメーター	型	既定値	説明
-Top	int	12	表示するセッションの最大数
-Csv	switch	-	既定のパスにエクスポート：~/.admin/logs/session-scout-YYYY-MM-DD.csv
-File	string	-	指定した CSV パスにエクスポート

Bash（session-scout.sh）：

パラメーター	型	既定値	説明
--top, -t	int	12	表示するセッションの最大数
--csv	flag	-	既定のパスにエクスポート：~/.admin/logs/session-scout-YYYY-MM-DD.csv
--file, -f	string	-	指定した CSV パスにエクスポート

---

セッションの保存場所

Claude Code (Windows):
  %USERPROFILE%\.claude\projects\{project-slug}\{uuid}.jsonl

Claude Code (macOS/Linux):
  ~/.claude/projects/{project-slug}/{uuid}.jsonl

Claude Desktop (Windows):
  %APPDATA%\Claude\
  %LOCALAPPDATA%\Claude\

Claude Desktop (macOS):
  ~/Library/Application Support/Claude/
  ~/Library/Application Support/Anthropic/

Claude Desktop (Linux):
  ~/.config/Claude/
  ~/.config/Anthropic/

OpenCode (Windows):
  %USERPROFILE%\.local\share\opencode\log\{timestamp}.log

OpenCode (macOS/Linux):
  ~/.local/share/opencode/log/{timestamp}.log

---

トラブルシューティング

問題：セッションが見つからない

解決策：想定される場所を手動で確認してください：

# macOS / Linux
find ~/.claude/projects -name '*.jsonl' 2>/dev/null | wc -l

# Windows
dir $env:USERPROFILE\.claude\projects -Recurse -Filter *.jsonl | measure

問題：WSL セッションが表示されない（Windows のみ）

解決方法：WSL が起動しており、ディストリビューションにアクセスできることを確認します。

wsl -l -q

問題：ProjectPath が空として表示される

解決方法：パスの抽出はベストエフォートです。セッションファイルの先頭 100 行に cwd フィールドが含まれていない場合があります。

---

出力例

Tool                            When                 ProjectPath                    Project              SessionId
----                            ----                 -----------                    -------              ---------
Claude Code (Windows)           1/26/2026 5:39:03 PM D:\admin                       D--admin             bdeb38c1-98a8-...
Claude Code (WSL:Ubuntu-24.04)  1/26/2026 1:47:28 PM /home/wsladmin/dev/vibe-skills -home-wsladmin-dev-v 3cd316dc-c168-...
OpenCode CLI                    1/26/2026 5:30:37 PM D:\rlm-project                                      2026-01-26T203036
OpenCode Desktop                1/26/2026 1:53:00 PM D:\wireframe-kit                                    2026-01-26T190547
Claude Desktop                  1/26/2026 10:10:18 AM                               sentry               session

---

セットアップ完了チェックリスト

macOS / Linux：

• Bash 4 以降がインストールされている（bash --version）
• スクリプトに実行権限がある（chmod +x session-scout.sh）
• テスト用の Claude Code/OpenCode セッションが少なくとも 1 つある

Windows：

• PowerShell 7 以降がインストールされている（pwsh --version）
• WSL2 がインストールされている（WSL セッションの検出に必要）
• テスト用の Claude Code/OpenCode セッションが少なくとも 1 つある