cline-session-history

Cline セッション履歴

ローカルマシンに保存されている Cline のセッション履歴を検索して閲覧します。セッションは ~/.cline/data/sessions/ に、個別の JSON メタデータファイルと会話トランスクリプト（.messages.json）ファイルとして保存されています。古いセッションは sessions.db SQLite データベースに保存されている場合もあります。

このスキルを使用する場面

• 「この1時間以内に使った、〜についてのセッションを探して」
• 「このプロンプトで始まったセッションを探して」
• 「〜について質問したセッションを探して」
• 「モデル X を使ったセッションを表示して」
• 「昨日失敗したセッションはどれ？」
• 「セッション のトランスクリプトを表示して」
• 「先週のセッションをフォルダーにエクスポートして」
• 「〜だったセッションはどれ？」
• 過去の Cline の会話履歴に関するリクエスト全般

使用方法

検索スクリプトは、このファイルと同じ場所にある scripts/search_sessions.py です。コマンドの実行場所にかかわらず動作するよう、現在の作業ディレクトリではなく、この SKILL.md が置かれているディレクトリを基準にパスを解決してください。

スクリプトのパス： scripts/search_sessions.py（このスキルのディレクトリを基準とする相対パス）

以下の例では scripts/search_sessions.py を使用します。別の場所から実行する場合は、スキルのディレクトリの絶対パスを先頭に付けてください。

すべてのフィルターは省略可能で、AND 条件で組み合わせられます。

簡単な使用例

# Sessions from the last 10 minutes
python3 scripts/search_sessions.py --since 10m

# Sessions between two dates with "chatgpt" in the prompt
python3 scripts/search_sessions.py --since 2026-06-01 --until 2026-06-21 --prompt chatgpt

# Find a session by its starting prompt (quoted substring match)
python3 scripts/search_sessions.py --since 1d --prompt "find some code that should be improved" --full-prompt

# Non-interactive sessions that failed
python3 scripts/search_sessions.py --no-interactive --status failed

# VS Code extension sessions using Claude models, full prompts
python3 scripts/search_sessions.py --source vscode --model "claude" --full-prompt

# Full transcript of a specific session
python3 scripts/search_sessions.py --session-id 1781991507587_pozk0 --transcript

# Export matching sessions to a directory
python3 scripts/search_sessions.py --since 1d --export ~/tmp/exported-sessions

時刻フィルター

--since と --until は、どちらも以下を受け付けます。

• 相対指定：10m、30min、2h、1d、1w（分、時間、日、週）
• ISO 8601：2026-06-20、2026-06-20T21:30:00Z、2026-06-20T21:30:00+00:00

利用可能なすべてのフィルター

フィルター	説明
--since <time>	この時刻より後に開始したセッション
--until <time>	この時刻より前に開始したセッション
--prompt <text>	プロンプト内の大文字・小文字を区別しない部分一致検索
--prompt-regex <pattern>	プロンプト内の正規表現検索（大文字・小文字を区別しない）
--status <status>	running、idle、completed、cancelled、failed
--source <source>	cli、vscode など（完全一致）
--provider <name>	プロバイダー名（完全一致、例：cline）
--model <text>	モデル名の部分一致（大文字・小文字を区別しない、例：claude）
--mode <mode>	plan または act
--cwd <path>	作業ディレクトリの部分一致
--session-id <id>	セッション ID の完全一致検索
--interactive / --no-interactive	インタラクティブフラグでフィルター
--team-only / --no-team	チームセッションフラグでフィルター
--subagents / --no-subagents	サブエージェントのセッションを含める／除外する

出力オプション

オプション	説明
--full-prompt	省略せずにプロンプトの全文を表示
--transcript	会話トランスクリプト全体を出力
--max-messages <n>	トランスクリプト出力のメッセージ数を制限
--content-types <types>	カンマ区切り：text,thinking,tool_use,tool_result,image
--export <dir>	一致したセッションファイルをディレクトリにコピー
--limit <n>	返すセッションの最大数
--json	JSON 形式で出力

データソースのオプション

オプション	説明
--sessions-dir <path>	カスタムのセッションディレクトリ（デフォルト：~/.cline/data/sessions）
--db-path <path>	カスタムの sessions.db パス
--no-db	SQLite データベースをスキップし、JSON ファイルのみを検索

ワークフロー

1. まず、ユーザーの条件で検索を実行し、一致するセッションの一覧を取得します。
2. ユーザーが詳細を見たい場合は、--full-prompt または --transcript を使用します。
3. トランスクリプトを確認するときは、関連する箇所に絞るために --max-messages と --content-types の使用を検討してください。
4. 複数のセッションをエクスポートするには、--export <dir> を使用してセッションファイルをコピーします。

セッションデータ構造

ディスク上の各セッションには、次のファイルがあります。

• <session_id>.json — メタデータ：session_id、started_at、status、source、provider、model、cwd、prompt、metadata（mode、systemPrompt、cost、usage）など。
• <session_id>.messages.json — メッセージにコンテンツブロック（text、thinking、tool_use、tool_result、image）が含まれる、会話の完全なトランスクリプト。

SQLite の sessions.db には、transcript_path、hook_path、parent_session_id、agent_id、is_subagent など、同様のフィールドを含む古いセッションが格納されている場合があります。