session-report

Hit a rate limit? Switch tools without losing context. Need to share your work? Export everything into one document.

session-report reads your AI coding sessions from Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode, and GitHub Copilot and exports them as Markdown, JSON, or DOCX — across any number of sessions, tools, or Git worktrees.

What it solves

Switching tools mid-build Hit Claude's rate limit? Run session-report copy and paste directly into Codex, Cursor, or any other AI tool. Full context, zero re-explaining.

Sharing your work Need to submit or review what you built with AI? One command generates a clean, readable document of everything — regardless of which tools you used.

Quickstart

npm install -g session-report
session-report export               # exports as Markdown (default)
session-report export --format json # exports as JSON
session-report export --format docx # exports as DOCX

Installation

npm

npm install -g session-report

npx (no install)

npx session-report export               # Markdown
npx session-report export --format docx # DOCX

Usage

Check what sessions are on your machine

session-report scan
session-report list

Copy session context to clipboard (for switching AI tools)

session-report copy                        # copy most recent session
session-report copy --last 3               # copy last 3 sessions
session-report copy --provider claude      # copy most recent Claude session
session-report copy --session abc123       # copy a specific session

The copied text is ready to paste directly into Claude, ChatGPT, Gemini, or any other AI tool.

Export everything into one document

session-report export                          # Markdown (default)
session-report export --format json            # JSON
session-report export --format docx            # DOCX
session-report export --output ./output        # custom output dir

Export sessions from a specific project or worktree

session-report export --repo my-project
session-report export --worktree

Export from a specific tool

session-report export --provider claude
session-report export --provider codex  --format json
session-report export --provider gemini --format docx
session-report export --provider opencode
session-report export --provider copilot --format docx

One file per session

session-report export --mode single --output ./sessions
session-report export --mode single --format json --output ./sessions

Export the current (most recent) session

session-report export --last 1                           # most recent session, any provider
session-report export --last 1 --provider claude         # most recent Claude session
session-report export --last 3                           # last 3 sessions across all providers

Filter by date

session-report export --since 2026-04-01
session-report export --since 2026-04-01 --format json

Commands

| Command | Description | |---|---| | scan | Summary of all detected sessions by provider | | list | Browse sessions with filters | | copy | Copy session context to clipboard for pasting into another AI tool | | export | Export sessions to Markdown, JSON, or DOCX |

Flags

Filter flags (list and export)

| Flag | Description | |---|---| | -p, --provider <provider...> | Filter by provider: claude, codex, cursor, gemini, opencode, copilot | | --repo <name> | Substring match on repository name | | --worktree | Only include worktree sessions | | --session <id> | Filter by session ID prefix | | --since <date> | Only sessions after this ISO date | | --until <date> | Only sessions before this ISO date | | --no-housekeeping | Exclude sessions with no assistant output |

Copy flags

| Flag | Description | |---|---| | --last <n> | Number of most recent sessions to include (default: 1) | | --max-chars <n> | Truncate output to N characters, 0 = unlimited (default: 0) | | --stdout | Print to stdout instead of copying to clipboard | | --include-tool-calls | Include tool call/result events | | --include-thinking | Include thinking blocks | | --include-timestamps | Prefix each event with its timestamp |

Export flags

| Flag | Description | |---|---| | --last <n> | Number of most recent sessions to include | | --format <format> | md (default), json, or docx | | --mode <mode> | combined (default), single, split-provider, split-repo | | --output <dir> | Output directory (default: ./session-reports) | | --include-tool-calls | Include tool call/result events | | --include-meta | Include system/meta events | | --include-thinking | Include thinking blocks | | --include-timestamps | Prefix each event with its timestamp | | --max-tool-lines <n> | Max lines of tool output to include (default: 50) |

Global flags

| Flag | Description | |---|---| | --claude-root <path> | Override ~/.claude directory | | --codex-root <path> | Override ~/.codex directory | | --cursor-root <path> | Override ~/.cursor directory |

Where sessions are read from

| Tool | Location | |---|---| | Claude Code | ~/.claude/projects/**/*.jsonl | | Codex CLI | ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl | | Cursor | ~/.cursor/projects/*/agent-transcripts/**/*.jsonl | | Cursor (chat DB) | ~/.cursor/chats/**/store.db | | Gemini CLI | ~/.gemini/tmp/**/session-*.json | | OpenCode | ~/.local/share/opencode/storage/session/**/*.json | | GitHub Copilot | ~/.copilot/session-state/**/*.jsonl |

Requirements

• Node.js >= 20

Development

git clone https://github.com/Adyasha8105/session-report.git
cd session-report
npm install
npm run dev -- scan
npm run typecheck
npm test
npm run build

License

MIT