🧹 Claude Clean

Transform messy Claude Code JSON logs into beautiful terminal output. ✨

Install:

curl -fsSL https://raw.githubusercontent.com/ariel-frischer/claude-clean/main/install.sh | sh

Use it:

claude -p "your prompt" --verbose --output-format stream-json | cclean

That's it! 🎉

Claude Code's stream-json output is unreadable:

{"type":"assistant","message":{"content":[{"type":"text","text":"Hello!"}],"usage":{"input_tokens":150,"output_tokens":45}}}

With cclean, you get beautiful output in multiple styles:

Default (-s default) — boxed with box-drawing characters:

┌─ SYSTEM [init]
│ Model: claude-sonnet-4-20250514
│ Claude Code: v1.0.12
│ Tools: 12 available
└─

┌─ ASSISTANT
│ I'll check the project structure first.
└─

┌─ TOOL: Bash
│ Input:
│   command: ls src/
└─

┌─ TOOL RESULT
│ index.ts
│ utils.ts
│ config.ts
└─

┌─ ASSISTANT
│ Found the source files. Let me read the config.
└─

┌─ TOOL: Read
│ Input:
│   file_path: src/config.ts
└─

┌─ RESULT: SUCCESS
│ Turns: 4
│ Duration: 12.35s (API: 8.21s)
│ Cost: $0.0142
│ Tokens: in=1250 out=380
└─

Compact (-s compact) — single-line summaries for quick scanning:

AST Hello! I can help you with that.
TOOL[Bash] echo "hello world"
RES hello world

Minimal (-s minimal) — clean and readable, no box-drawing:

ASSISTANT
  Hello! I can help you with that.

TOOL USE [Bash]
  echo "hello world"

Plain (-s plain) — no colors or formatting, ideal for piping/logs:

ASSISTANT
  Hello! I can help you with that.

TOOL USE [Bash]
  echo "hello world"

RESULT
  hello world

Bonus: Using -p with --output-format stream-json bypasses Claude's interactive UI, avoiding segfault issues some users experience.

curl -fsSL https://raw.githubusercontent.com/ariel-frischer/claude-clean/main/install.sh | sh

Download the appropriate binary for your platform from the latest release.

# After downloading, make it executable and move to PATH
chmod +x cclean-* && sudo mv cclean-* /usr/local/bin/cclean

git clone https://github.com/ariel-frischer/claude-clean && cd claude-clean
make install

cclean --uninstall

# 📡 Live streaming (most common)
claude -p "your prompt" --verbose --output-format stream-json | cclean

# 📄 From a file
cclean logs.jsonl

# 📥 From stdin
cat logs.jsonl | cclean

cclean -s compact logs.jsonl  # Try different styles!

• Usage Guide - Shell aliases, advanced examples, output styles
• Installation - Detailed installation options
• Development - Building from source, architecture
• Contributing - How to contribute
• Releases - Release process and versioning
• Auto-bump - Automatic version bumping

cclean --uninstall

MIT © Ariel Frischer