dashcc

A rich status bar for Claude Code.

Install

Note: Use npx — do not run npm i dashcc directly, as it may cause peer dependency conflicts.

npx dashcc --install

Restart Claude Code. Done.

Uninstall

npx dashcc --uninstall

Configure

npx dashcc

Opens an interactive TUI to customize widgets, colors, layout, and more.

Responsive Terminal Behavior

The default terminal width mode is now Responsive stable.

• narrow terminals reserve 50% of the measured width
• medium terminals reserve 30%
• wide terminals reserve 20%

That reserve is recalculated on every status line render, so the layout can shrink and expand cleanly between Claude Code turns instead of getting stuck in a compact state.

The default dashboard also compacts high-width widgets by priority:

• context bars shorten first
• session and weekly usage lines shorten their suffixes on medium widths
• session and weekly usage lines keep only the bar and percentage on narrow widths
• long Goal and Now summaries wrap by display width and clamp to 2 lines

Temporary Claude UI notices such as update messages are rendered as their own auxiliary line instead of competing with the main dashboard row.

Status Bar Layout

The default layout has 4 lines. Each line is fully customizable via the TUI.

Opus 4.6 · 1hr 24m · Session spending: $15.78 · [████████░░░░] 63k/200k (32%)
Session: [████░░░░] 26.0% · 0h19m left · Weekly: [██████░░░░] 28.0% · resets Thu 10pm
ccdash · Goal: Publish dashcc to npm
Now: Added --install and --uninstall CLI flags

Line 1 — Model, session duration, cost, and a context window progress bar.

Line 2 — API usage for the current block and the weekly quota, with countdown timers.

Line 3 — Project name and the session goal. The model writes the goal on its first response and updates it when the objective shifts.

Line 4 — What just happened. The model updates this after every response so you can glance at progress without scrolling.

You can change the width strategy in the TUI under Terminal Width, but Responsive stable is the recommended default for terminal usage.

All widgets

| Category | Widgets | |----------|---------| | Model | Model, Version, Output Style | | Git | Branch, Changes, Insertions, Deletions, Root Dir, Worktree | | Tokens | Input, Output, Cached, Total | | Speed | Input Speed, Output Speed, Total Speed | | Context | Length, %, % Usable, Context Bar | | Session | Clock, Cost, Name, ID, Status Summary, Skills | | Timers | Block Timer, Block Reset, Weekly Reset | | Usage | Session Usage, Weekly Usage | | System | Working Dir, Terminal Width, Memory | | Custom | Custom Text, Custom Command, Link | | Layout | Separator, Flex Separator |

License

MIT