cc2md 0.3.0

Convert Claude Code or Codex chat sessions to Markdown

cc2md

Convert Claude Code or Codex chat sessions to Markdown.

Install

pip install cc2md

Quick Start

# Extract the most recent session
cc2md --latest -o log

# Extract the most recent Codex session
cc2md --agent codex --latest -o log

If the session spawned subagents, output is a directory:

log/
  index.md                        # main conversation, with links to subagents
  reduce-min-host-层实现-a46d2ef.md
  reduce-min-device-层实现-a95f57b.md
  ...

Otherwise, a single log.md is written.

Agent Selection

Use --agent to choose which session format to read:

cc2md --agent claude --latest -o log
cc2md --agent codex --latest -o log

• claude reads Claude Code session logs
• codex reads Codex rollout logs

The default is claude.

Output Format

cc2md tries to keep the transcript easy to scan without losing tool detail:

• Sessions without subagents export as a single Markdown file
• Sessions with subagents export as a directory
• The main conversation is written to index.md
• Each subagent conversation is written to its own Markdown file
• index.md links to subagent files at the point where the subagent was spawned

Tool rendering rules:

• Tool calls remain expanded in the transcript
• Tool results are wrapped in <details> blocks so long outputs stay collapsible
• Code-editing operations are rendered inline instead of being collapsed
• Code-editing operations are shown with diff blocks when the source log contains structured edit data

Code-editing rendering currently covers operations such as:

• Write
• Add
• Edit
• MultiEdit
• apply_patch
• Delete / DeleteFile

Example result layout:

**Tool: exec_command**
```bash
git status --short
```

<details><summary>Result: exec_command</summary>

**Result: exec_command**
```
 M README.md
```

</details>

Example edit layout:

**Tool: apply_patch**
Applying patch
```diff
*** Begin Patch
*** Update File: README.md
@@
-old line
+new line
*** End Patch
```

**Result: apply_patch**
```
Success. Updated the following files:
M README.md
```

Usage

cc2md --list                        # list all sessions
cc2md --latest -o log               # most recent session
cc2md --agent codex --latest -o log # most recent Codex session
cc2md 1 -o log                      # by index from --list
cc2md a1b2c3 -o log                 # by UUID prefix
cc2md "auth middleware" -o log      # by title substring
cc2md --all -d ./exports/           # export everything
cc2md --latest -p myapp -o log      # filter by project

Options

Flag	Description
--list, -l	List available sessions
--latest	Most recent session
--all	Convert all sessions
--agent	Source backend: claude or codex
--project, -p	Filter by project path substring
--dir	Scan a custom directory instead of the default source directory
--output, -o	Output path
--output-dir, -d	Output directory for --all
--no-subagents	Exclude subagent conversations
--no-tool-results	Exclude tool call results

Requirements

Python 3.10+, no external dependencies.