Skip to content

Commit 61ee25a

Browse files
zackman0010claude
andcommitted
Update README with project command, code/cowork shortcuts, and --source docs
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 72d8b67 commit 61ee25a

File tree

1 file changed

+33
-3
lines changed

1 file changed

+33
-3
lines changed

README.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,12 @@ uvx claude-code-transcripts --help
3030

3131
This tool converts Claude Code session files into browseable multi-page HTML transcripts.
3232

33-
There are four commands available:
33+
There are seven commands available:
3434

35-
- `local` (default) - select from local Claude Code sessions stored in `~/.claude/projects`
35+
- `local` (default) - select from recent local Claude Code or Cowork sessions
36+
- `code` - shortcut for `local --source code`
37+
- `cowork` - shortcut for `local --source cowork`
38+
- `project` - select a single project and convert all its sessions to an archive
3639
- `web` - select from web sessions via the Claude API
3740
- `json` - convert a specific JSON or JSONL session file
3841
- `all` - convert all local sessions to a browsable HTML archive
@@ -70,12 +73,39 @@ claude-code-transcripts
7073
claude-code-transcripts local
7174
```
7275

76+
By default the picker shows sessions from both Claude Code and Claude Cowork. Use `--source` to restrict to one:
77+
78+
```bash
79+
claude-code-transcripts local --source code # Code sessions only
80+
claude-code-transcripts local --source cowork # Cowork sessions only
81+
# or use the shortcut commands:
82+
claude-code-transcripts code
83+
claude-code-transcripts cowork
84+
```
85+
7386
Use `--limit` to control how many sessions are shown (default: 10):
7487

7588
```bash
7689
claude-code-transcripts local --limit 20
7790
```
7891

92+
### Converting a single project
93+
94+
Select a project and convert all of its sessions to a browsable HTML archive:
95+
96+
```bash
97+
claude-code-transcripts project
98+
```
99+
100+
This presents an interactive picker listing all your projects with their session counts. After you select one, it generates the same archive structure as the `all` command but for only that project.
101+
102+
Options:
103+
104+
- `-s, --source` - source: `code` (default Code path), `cowork`, or a path to a projects directory
105+
- `-o, --output DIRECTORY` - output directory (default: `./claude-archive`)
106+
- `--open` - open the generated project index in your browser
107+
- `--json` - include the original session files in the output directory
108+
79109
### Web sessions
80110

81111
Import sessions directly from the Claude API:
@@ -188,7 +218,7 @@ This creates a directory structure with:
188218

189219
Options:
190220

191-
- `-s, --source DIRECTORY` - source directory (default: `~/.claude/projects`)
221+
- `-s, --source` - source: `code` (default Code path), `cowork`, or a path to a projects directory. Omit to include both Code and Cowork.
192222
- `-o, --output DIRECTORY` - output directory (default: `./claude-archive`)
193223
- `--include-agents` - include agent session files (excluded by default)
194224
- `--dry-run` - show what would be converted without creating files

0 commit comments

Comments
 (0)