Cline Session History

Search and browse Cline session history stored on the local machine. Sessions live in ~/.cline/data/sessions/ as individual JSON metadata files and conversation transcript (.messages.json) files. Older sessions may also be in a sessions.db SQLite database.

When to Use This Skill

• "Find my session from the last hour about..."
• "Find my session that started with this prompt..."
• "Find the session where I asked about..."
• "Show me sessions that used model X"
• "What sessions failed yesterday?"
• "Show me the transcript for session "
• "Export sessions from last week to a folder"
• "What was that session where..."
• Any request involving past Cline conversation history

How to Use

The search script lives alongside this file at scripts/search_sessions.py, relative to the skill's own directory. Resolve it against the directory that contains this SKILL.md — not the current working directory — so it works regardless of where the command is run from.

Script path: scripts/search_sessions.py (relative to this skill's directory)

The examples below use scripts/search_sessions.py; prefix it with the skill directory's absolute path when running from elsewhere.

All filters are optional and combine with AND logic.

Quick Examples

# 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

Time Filters

Both --since and --until accept:

• Relative: 10m, 30min, 2h, 1d, 1w (minutes, hours, days, weeks)
• ISO 8601: 2026-06-20, 2026-06-20T21:30:00Z, 2026-06-20T21:30:00+00:00

All Available Filters

Output Options

Data Source Options

Workflow

1. Start by running the search with the user's criteria to get a list of matching sessions.
2. If the user wants to see details, use --full-prompt or --transcript.
3. For transcript inspection, consider --max-messages and --content-types to focus on relevant parts.
4. For bulk export, use --export <dir> to copy session files.

Session Data Structure

Each session on disk has:

• <session_id>.json — Metadata: session_id, started_at, status, source, provider, model, cwd, prompt, metadata (mode, systemPrompt, cost, usage), etc.
• <session_id>.messages.json — Full conversation transcript with messages containing content blocks (text, thinking, tool_use, tool_result, image).

The SQLite sessions.db may contain older sessions with similar fields plus transcript_path, hook_path, parent_session_id, agent_id, is_subagent.