claude-code-pretty

Pretty formatter for Claude Code - stream sessions in real-time or replay saved .jsonl files.

without claude-code-pretty	with claude-code-pretty

Features

• stream mode - run claude with pretty output in real-time
• replay mode - replay saved .jsonl session files
• tool display - formatted output for Glob, Grep, Bash, Read, Edit, etc.
• markdown - renders bold and code with ANSI styles
• subagent depth - visual indentation for nested Task calls
• cost tracking - shows duration, cost, tokens per session

Installation

pip install claude-code-pretty

Aliases: claudep, ccp, claude-code-pretty

Usage

# stream - run claude with pretty output (all args forwarded to claude)
claudep stream -p "explain this code"
claudep stream -p "fix the bug" --model sonnet --max-turns 3
claudep stream --resume

# show - replay a saved session in terminal
claudep show ~/.claude/projects/.../session.jsonl

Stream mode adds these flags automatically:

--print --verbose --dangerously-skip-permissions --output-format stream-json --include-partial-messages

Environment

Development

make install      # setup venv + install
make test         # run pytest
make check        # ruff lint

# dev alias (claudepd)
ln -sf $(pwd)/.venv/bin/claudep ~/.local/bin/claudepd # install
rm ~/.local/bin/claudepd                              # remove

License

MIT