Sessions

Session Replay

What did you do yesterday?

npx promptreports-cli sessions

Searchable history of every Claude Code session with cost, turn count, model, content preview. Replay turn-by-turn.

sessions is your time machine. List every Claude Code session with date, turn count, cost, and summary. Replay any session turn-by-turn to see exactly what you asked, what the model did, and how much it cost. Search by keyword across all sessions. Extract recurring patterns (which skills do you use most? which tasks repeat?). Export any session to markdown.

Prerequisites

Session files in ~/.claude/projects/

Flags & Options

Flag	Description	Default
--days N	Lookback	7
--list	List all sessions	true
--replay <id>	Replay one session turn-by-turn	—
--search <term>	Search prompts across all sessions	—
--extract-patterns	Top 10 recurring keywords/tasks	—
--export <id>	Export session to session-{id}.md	—
--json	JSON output	—

Examples

List sessions

npx promptreports-cli sessions

7-day table with ID, date, turns, cost, summary.

Replay one session

npx promptreports-cli sessions --replay a1b2c3d4

Every turn, every cost, every prompt preview.

Search history

npx promptreports-cli sessions --search "prisma migration"

Find every time you touched Prisma migrations.

Export for sharing

npx promptreports-cli sessions --export a1b2c3d4

Creates session-a1b2c3d4.md — share with team.

Output

Either session list table OR per-turn replay detail OR search results OR extracted patterns.

  Session a1b2c3d4 — 04/17/2026
  Duration: 23m | Turns: 12 | Cost: $0.45 | Model: claude-opus-4-6

    #001  10:30:45   234 tokens    $0.012   Read the README to understand project structure
    #002  10:31:02   567 tokens    $0.034   Now implement authentication for the signup flow
    #003  10:31:48   1,234 tokens  $0.067   Add the login page with form validation
    #004  10:32:30   890 tokens    $0.052   Fix the type error on line 42
    ...

What it reads and writes

Reads

~/.claude/projects/**/*.jsonl

Writes

session-{id}.md (with --export)

Free vs Pro usage

Free tier

Replay what you did last Friday to onboard a teammate
Search "how did I solve X?" across months of history
Export to markdown to build a personal wiki

Pro tier

Upgrade

Team session sharing — "here's how I debugged this" with one URL
Auto-extracted patterns feed into a team knowledge base
Session templates — start new work from a proven past flow
AI-generated learnings from your session history

Pro tips

Session IDs are the first 8 chars of the filename — tab-complete works
Export is great for documenting tricky debugs — just email yourself the .md
--extract-patterns is weekly gold — run it every Friday

Free to try

Install the whole toolkit.

One command unlocks all 23 tools.

Start Free Back to all tools