Skip to main content

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

Variable Default Description
CP_TOOL_RESULT_MAX_CHARS 300 Max chars for tool results (0=hide)
CP_READ_PREVIEW_LINES 5 Lines to preview from Read (0=hide)

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_code_pretty-0.1.3.tar.gz (555.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_code_pretty-0.1.3-py3-none-any.whl (16.1 kB view details)

Uploaded Python 3

File details

Details for the file claude_code_pretty-0.1.3.tar.gz.

File metadata

  • Download URL: claude_code_pretty-0.1.3.tar.gz
  • Upload date:
  • Size: 555.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for claude_code_pretty-0.1.3.tar.gz
Algorithm Hash digest
SHA256 790eabafd4931bef49c1833e12fe68a456d77cc77e15700730d0218fe52de413
MD5 00eab51299de8d3311f113bed5b88bea
BLAKE2b-256 74d8fbfb72dfd1fa6e4da87db008d8986abdd205f3f3c15c3e5adc8cdce9fca8

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_code_pretty-0.1.3.tar.gz:

Publisher: release.yml on lucasvtiradentes/claude-code-pretty

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file claude_code_pretty-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for claude_code_pretty-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6f98d6d8cf1970c0e502e2420092cb3f0329498fdd760401e1067749f309676e
MD5 d4972831b67925a74e67bef993ad749c
BLAKE2b-256 c3c36a6dd4a1c08d43f6a3aa51b345af8867b47ea63dbfdb3435f03727f515c9

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_code_pretty-0.1.3-py3-none-any.whl:

Publisher: release.yml on lucasvtiradentes/claude-code-pretty

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page