Skip to main content

Pretty formatter for Claude Code stream-json output

Project description

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

Project details


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.

Supported by

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