Claude Chat To Md

claude-chat-to-md

Convert [Claude Code](https://docs.anthropic.com/en/docs/claude-code) chat sessions to clean, readable Markdown — including subagent conversations.

Claude Code persists full chat history as JSONL files under `~/.claude/projects/`. This tool reads those files and produces well-formatted Markdown with proper headings, code blocks, and collapsible sections for tool results and subagent conversations.

Install

pipx install claude-chat-to-md

Or with pip:

pip install claude-chat-to-md

Or run directly from source:

git clone https://github.com/luckynick/claude-chat-to-md.git
cd claude-chat-to-md
pip install -e .

Usage

List sessions

claude-chat-to-md --list

#    Date                 ID           Title                                              Project
------------------------------------------------------------------------------------------------------------------------
1    2025-10-15 14:30     a1b2c3d4..   Refactor auth middleware                            dev/myapp
2    2025-10-14 09:15     e5f6a7b8..   Add user settings page                              dev/myapp
3    2025-10-13 16:45     c9d0e1f2..   Debug CI pipeline                                   dev/infra

Convert a session

# By index (from --list)
claude-chat-to-md 1 -o chat.md

# By UUID prefix
claude-chat-to-md a1b2c3 -o chat.md

# By title substring
claude-chat-to-md "auth middleware" -o chat.md

# Most recent session
claude-chat-to-md --latest -o chat.md

Filter by project

claude-chat-to-md --list --project myapp
claude-chat-to-md --latest --project myapp -o chat.md

Export all sessions

claude-chat-to-md --all --output-dir ./exports/

Options

Flag	Description
--list, -l	List all available sessions
--latest	Convert the most recent session
--all	Convert all sessions
--project, -p	Filter sessions by project pa