ct - Claude Transcripts
A CLI tool for converting Claude Code session transcripts to markdown.
What It Does
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
Quick Start
# 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
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
Commands
| Command | Description |
|---|---|
ct list |
List projects or sessions |
ct convert |
Export specific projects to markdown |
ct sync |
Sync all transcripts incrementally |
ct backup |
Copy all transcripts to a directory |
See Command Reference for full options.
Development
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
just build # Build the binary
just test # Run tests
just dev # Format, vet, and test
just ci # Full CI check
Documentation
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
Project Status
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
Inspired By
This project was inspired by claude-code-transcripts by Simon Willison.
License
MIT