@@ -26,11 +26,12 @@ uvx claude-code-transcripts --help
2626
2727This tool converts Claude Code session files into browseable multi-page HTML transcripts.
2828
29- There are three commands available:
29+ There are four commands available:
3030
3131- ` local ` (default) - select from local Claude Code sessions stored in ` ~/.claude/projects `
3232- ` web ` - select from web sessions via the Claude API
3333- ` json ` - convert a specific JSON or JSONL session file
34+ - ` batch ` - convert all local sessions to a browsable HTML archive
3435
3536The quickest way to view a recent local session:
3637
@@ -99,6 +100,44 @@ claude-code-transcripts json session.jsonl --open
99100
100101When using [ Claude Code for web] ( https://claude.ai/code ) you can export your session as a ` session.json ` file using the ` teleport ` command.
101102
103+ ### Batch conversion
104+
105+ Convert all your local Claude Code sessions to a browsable HTML archive:
106+
107+ ``` bash
108+ claude-code-transcripts batch
109+ ```
110+
111+ This creates a directory structure with:
112+ - A master index listing all projects
113+ - Per-project pages listing sessions
114+ - Individual session transcripts
115+
116+ Options:
117+
118+ - ` -s, --source DIRECTORY ` - source directory (default: ` ~/.claude/projects ` )
119+ - ` -o, --output DIRECTORY ` - output directory (default: ` ./claude-archive ` )
120+ - ` --include-agents ` - include agent session files (excluded by default)
121+ - ` --dry-run ` - show what would be converted without creating files
122+ - ` --open ` - open the generated archive in your default browser
123+ - ` -q, --quiet ` - suppress all output except errors
124+
125+ Examples:
126+
127+ ``` bash
128+ # Preview what would be converted
129+ claude-code-transcripts batch --dry-run
130+
131+ # Convert all sessions and open in browser
132+ claude-code-transcripts batch --open
133+
134+ # Convert to a specific directory
135+ claude-code-transcripts batch -o ./my-archive
136+
137+ # Include agent sessions
138+ claude-code-transcripts batch --include-agents
139+ ```
140+
102141### Auto-naming output directories
103142
104143Use ` -a/--output-auto ` to automatically create a subdirectory named after the session:
0 commit comments