v1.0.8

What's Changed

• v1.0.8 by @ydking0911 in #16

Full Changelog: v1.0.7...v1.0.8

v1.0.7

What's Changed

• fix: release npm deploy changed by @ydking0911 in #11
• v1.0.7 by @ydking0911 in #12
• v1.0.7 by @ydking0911 in #13
• v1.0.7 by @ydking0911 in #14
• v1.0.7 by @ydking0911 in #15

Full Changelog: v1.0.6...v1.0.7

[RELEASE] v1.0.4

What's claude-trace?

See every tool call Claude Code makes — live, in your terminal.

Claude Code only shows a spinner. claude-trace splits your terminal and renders a real-time tree of every tool call, with progress bar, token usage, and an animated pixel-art companion.

What's new in v1.0.4

Token tracking — now actually works

Token usage was previously hardcoded to zero. claude-trace now reads directly from Claude Code's own JSONL transcript files (~/.claude/projects/**/*.jsonl) and counts real output tokens.

Persistent across restarts

Historical token usage is scanned from all past sessions on startup — no separate tracking file needed. Even on first install, your full Claude usage history is reflected immediately.

Level system

Token usage now drives an exponential level bar with no cap.

Lv.1: 0–1K   Lv.2: 1K–3K   Lv.3: 3K–7K   Lv.4: 7K–15K   …

Each level requires twice the tokens of the previous one.

Session & weekly usage bars

Two new bars in the stats footer:

• 🟠 Session — context window usage (input + cache tokens / 200K), with active session time
• 🟢 Weekly — output tokens used this calendar week, with countdown to Monday reset

Features

• Live tool tree — Every Read, Edit, Bash, and subagent call rendered as a tree in real time
• Progress bar — Completed / total tools updated as each tool finishes
• Stats footer — Token level bar, session context bar, weekly usage bar, cost, elapsed time
• Pixel-art sprite — Animated character whose expression changes with tool activity
• Non-invasive — Uses Claude Code's official HTTP hook system; no source modification required
• Auto-restore — .claude/settings.json restored to original state on exit

Installation

npm:

npm install -g claude-trace

Homebrew:

brew tap ydking0911/claude-trace
brew install claude-trace

Usage

claude-trace "fix the bug in auth.ts"

Credits

Pixel-art sprites by sk-ruban/notchi (MIT).

[RELEASE] v1.0.3

What's claude-trace?

See every tool call Claude Code makes — live, in your terminal.

Claude Code only shows a spinner. claude-trace splits your terminal and renders a real-time tree of every tool call, with progress bar, token usage, and an animated pixel-art companion.

Features

• Live tool tree — Every Read, Edit, Bash, and subagent call rendered as a tree in real time
• Progress bar — Completed / total tools updated as each tool finishes
• Stats footer — Token usage, estimated cost, and elapsed time
• Pixel-art sprite — Animated character whose expression changes with tool activity
• Non-invasive — Uses Claude Code's official HTTP hook system; no source modification required
• Auto-restore — .claude/settings.json restored to original state on exit

Installation

npm:

npm install -g claude-trace

Homebrew:

brew tap ydking0911/claude-trace
brew install claude-trace

Usage

claude-trace "fix the bug in auth.ts"

Credits

Pixel-art sprites by sk-ruban/notchi (MIT).