Skip to content

Commit f379c01

Browse files
brendanbeckerclaude
andcommitted
Add batch command documentation to README
Document the new batch command that converts all local Claude Code sessions to a browsable HTML archive with master and project indexes. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent f16bf2d commit f379c01

File tree

1 file changed

+40
-1
lines changed

1 file changed

+40
-1
lines changed

README.md

Lines changed: 40 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,12 @@ uvx claude-code-transcripts --help
2626

2727
This 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

3536
The quickest way to view a recent local session:
3637

@@ -99,6 +100,44 @@ claude-code-transcripts json session.jsonl --open
99100

100101
When 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

104143
Use `-a/--output-auto` to automatically create a subdirectory named after the session:

0 commit comments

Comments
 (0)