Cc2md

cc2md

Convert Claude Code session logs into clean, shareable markdown.

Claude Code stores session logs as JSONL files in ~/.claude/projects/. cc2md reads those logs and renders them in the terminal with glamour, or exports raw markdown to files. When invoked with no arguments in a TTY, it launches an interactive session picker.

Installation

Homebrew

Go

Binary

Download a pre-built binary from GitHub Releases.

Quick Start

Usage

Commands

Flags

Output

Rendering

Formatting

List subcommand

Environment Variables

Markdown Flavors

By default, cc2md uses CommonMark for terminal rendering and GFM when writing to a file (--output) or emitting raw markdown (--raw). Use --markdown to override:

- gfm — GitHub Flavored Markdown: > [!NOTE] alerts,  tags
- commonmark — Portable markdown: > Note: blockquotes, expanded sections

Examples

Archiving Your Conversations in Git

Claude Code deletes session logs after 30 days. You can use cc2md to build a permanent, version-controlled archive of every AI conversation — searchable with grep, reviewable in any editor, and backed up to a remote.

Set up a log repository:

Export all sessions:

Commit and push:

Run this on a schedule (cron, launchd) to keep the archive growing automatically. Over time you get a complete record of how you work with AI — which patterns you return to, how your prompting evolves, and which approaches work across projects.

Building from Source

Requires Go 1.25+ and just.

License

MIT