A CLI tool for converting Claude Code session transcripts to markdown.

Claude Code stores conversation transcripts as JSONL files in ~/.claude/projects/. This tool makes them:

• Readable — Converts raw JSONL to clean markdown with metadata
• Exportable — Generate markdown files you control
• Backupable — Copy entire transcript directory

# Install (requires Go 1.21+)
go install github.com/robertguss/claude-transcripts@latest

# List your projects
ct list

# Convert a project's transcripts to markdown
ct convert my-project -o ./transcripts

# Sync all transcripts (incremental)
ct sync -o ./transcripts

# Copy all transcripts
ct backup ./backup

See Command Reference for full options.

This project uses just as a command runner. Run just to see available commands:

just          # List all commands
just build    # Build the binary
just test     # Run tests
just dev      # Format, vet, and test
just ci       # Full CI check

For Users:

• Getting Started — Installation and first use
• Command Reference — All commands and options
• Troubleshooting — Common issues

For Developers:

• Architecture — System design and data flow
• Contributing — How to contribute
• API Reference — Package documentation

Core functionality implemented:

• Project/session listing with metadata
• Markdown export with YAML frontmatter
• Incremental sync (only converts new/changed)
• Backup command

Coming soon:

• Static HTML site generation
• Full-text search

This project was inspired by claude-code-transcripts by Simon Willison.

MIT