Skip to content

Releases: jedarden/ccdash

v0.9.4 - Single-line status bar in wide mode

16 Apr 00:54

Choose a tag to compare

Wide and ultrawide terminals (>=120 cols) now show a single-line status bar:

15:04:05 v0.9.4 https://github.com/jedarden/ccdash 120x68 l:lookback h:help q:quit r:refresh

The two-line format (repo link on its own line) is kept only for the compact layout (<120 cols) where there isn't enough width to fit everything inline. Panel height offsets for wide/ultrawide are also restored to their original values.

v0.9.3 - Single-column sessions by default

16 Apr 00:18

Choose a tag to compare

Fixes the tmux sessions panel always showing 2 columns in narrow terminals.

The cell-width expansion logic (which added columns purely to avoid wide cells) was firing unconditionally, forcing 2 columns on any terminal wider than 55 chars. It now only applies when sessions already overflow the available lines — so the panel stays at 1 column until there are genuinely too many sessions to show vertically.

v0.9.2 - Persistent repo link + auto-updater space

16 Apr 00:07

Choose a tag to compare

What's New

Two-line status bar

The status bar is now two lines at the bottom of every view:

         https://github.com/jedarden/ccdash
15:04:05 v0.9.2   75x68  l:lookback h:help q:quit r:refresh
  • Line 1 always shows the repo URL, centred — replaced by the update notification when a newer version is available, or by progress during an update
  • Line 2 retains the existing time/version + dimensions/shortcuts format

This means the repo link is always visible and the auto-updater notification has a dedicated line that never displaces other content.

Height corrections

All three layout render paths (ultrawide, wide, compact) had their panel-height offsets increased by 1 to account for the extra status bar line, preventing any overflow.

v0.9.1 - Fix compact layout height overflow

15 Apr 22:21

Choose a tag to compare

Fixes the tmux sessions panel being cut off at the top in narrow terminals (e.g. 71×68, 75×68).

Root cause: lipgloss.Height() sets the inner content height; each panel renders at height+2 rows due to top/bottom borders. With 3 stacked panels the total overhead is 3×2=6 border rows + 1 status bar = 7, not 5. The off-by-two caused content to overflow, pushing the tmux panel header off screen.

v0.9.0 - Compact Layout for Narrow Terminals

15 Apr 22:05

Choose a tag to compare

What's New

Compact Layout for Narrow Terminals

Adds a new LayoutCompact mode that activates automatically when the terminal is narrower than 120 columns (e.g. 75×68).

Panels are stacked vertically in this order:

  • Tmux sessions — top (half the available height)
  • Token usage — middle
  • System resources — bottom

Bug Fix

  • Fixed duplicate map key glm-4-alltools that prevented compilation

v0.8.0 - Disk Usage Monitoring

10 Feb 03:14

Choose a tag to compare

Release v0.8.0

New Features

Disk Usage Monitoring in System Resources Panel

What's New:

  • System Resources panel now displays root filesystem (/) disk space usage
  • Shows used/total space with a visual percentage bar
  • Uses the same compact, color-coded format as Memory and Swap metrics

Display Format:

Dsk [||||||                        15.9%] 66.12 GB/444.00 GB

Color Coding:

  • 🟢 Green: < 60% used
  • 🟡 Yellow: 60-79% used
  • 🟠 Orange: 80-94% used
  • 🔴 Red: ≥ 95% used

Position:

  • Located between Swap and Disk I/O metrics for logical grouping of storage resources

Benefits:

  • Quick visibility into available disk space without leaving ccdash
  • Early warning when disk usage approaches capacity
  • Consistent with existing memory and swap monitoring

Technical Details:

  • Monitors root filesystem (/) using gopsutil/v3/disk.Usage()
  • Real-time updates every 2 seconds (same as other system metrics)
  • Help text updated (press h in ccdash to view)

Installation

Linux AMD64

wget https://github.com/jedarden/ccdash/releases/download/v0.8.0/ccdash-linux-amd64
chmod +x ccdash-linux-amd64
sudo mv ccdash-linux-amd64 /usr/local/bin/ccdash

Linux ARM64

wget https://github.com/jedarden/ccdash/releases/download/v0.8.0/ccdash-linux-arm64
chmod +x ccdash-linux-arm64
sudo mv ccdash-linux-arm64 /usr/local/bin/ccdash

macOS AMD64

wget https://github.com/jedarden/ccdash/releases/download/v0.8.0/ccdash-darwin-amd64
chmod +x ccdash-darwin-amd64
sudo mv ccdash-darwin-amd64 /usr/local/bin/ccdash

macOS ARM64 (Apple Silicon)

wget https://github.com/jedarden/ccdash/releases/download/v0.8.0/ccdash-darwin-arm64
chmod +x ccdash-darwin-arm64
sudo mv ccdash-darwin-arm64 /usr/local/bin/ccdash

Self-Update (Existing Users)

If you already have ccdash installed:

# ccdash will notify you when an update is available
# Press 'u' in the dashboard to auto-update to v0.8.0

Or manually update:

# Check current version
ccdash --version

# Update to latest
ccdash --update

Checksums

9be4b99656720c4d1474b738231d5c9002b0f2a33c5035a7d701d7129140e919  ccdash-linux-amd64
dd3288a0f943578c24f25e3a64a2c1cbcf420c9553cbb33d92dd2f5dab252444  ccdash-linux-arm64
c909f307660c0d7e3341e97b13fd19a289964a5382be395c99a5c5b78044b8f7  ccdash-darwin-amd64
9b607644f228b889aa7c3d2a1ad6600c54eeb1eea9900855c58bd7e18e1bc4af  ccdash-darwin-arm64

Full Changelog

See CHANGELOG.md for complete version history.

Upgrading from v0.7.23

No breaking changes. Simply replace your binary with the new version.

The disk usage metric will appear automatically in the System Resources panel.

v0.7.23 - Fix PID Tracking for Claude Code Sessions

09 Feb 14:36

Choose a tag to compare

Release v0.7.23

Bug Fixes

Fixed PID Tracking for Claude Code Sessions

Problem:

  • Session hooks were incorrectly storing the hook script's PID ($$) instead of the actual Claude Code process PID
  • Hook scripts exit immediately after execution, leaving dead PIDs in session files
  • When Claude Code restarts in the same tmux window, old session files with stale PIDs remained
  • ccdash displayed all sessions as "ready" despite them actively running, because the tracked PIDs were dead

Solution:

  • Session hooks now walk up the process tree from $PPID to find the actual "claude" process
  • Store the real Claude Code process PID instead of the ephemeral hook script PID
  • Automatically clean up old session files for the same tmux session when a new session starts
  • prompt-submit hook now updates the PID to handle cases where the process restarted

Impact:

  • Sessions now correctly show as "working" or "active" when Claude Code is running
  • No more false "ready" status for active sessions
  • Accurate process tracking even when Claude Code restarts in the same tmux window

Testing:

  • Verified hook captures running Claude process PID correctly
  • Confirmed PID is valid and points to actual "claude" process
  • Old stale session files are properly cleaned up on new session start

Installation

Linux AMD64

wget https://github.com/jedarden/ccdash/releases/download/v0.7.23/ccdash-linux-amd64
chmod +x ccdash-linux-amd64
sudo mv ccdash-linux-amd64 /usr/local/bin/ccdash

Linux ARM64

wget https://github.com/jedarden/ccdash/releases/download/v0.7.23/ccdash-linux-arm64
chmod +x ccdash-linux-arm64
sudo mv ccdash-linux-arm64 /usr/local/bin/ccdash

macOS AMD64

wget https://github.com/jedarden/ccdash/releases/download/v0.7.23/ccdash-darwin-amd64
chmod +x ccdash-darwin-amd64
sudo mv ccdash-darwin-amd64 /usr/local/bin/ccdash

macOS ARM64 (Apple Silicon)

wget https://github.com/jedarden/ccdash/releases/download/v0.7.23/ccdash-darwin-arm64
chmod +x ccdash-darwin-arm64
sudo mv ccdash-darwin-arm64 /usr/local/bin/ccdash

Update Hooks

After installing the new binary, reinstall the hooks to get the fixes:

ccdash --install-hooks

This will update the hook scripts in ~/.ccdash/hooks/ with the corrected PID tracking logic.

Checksums

be3d1f5269732cea4a6a639684f763ccef7970de4b503a80b56f8a210fd3d56d  ccdash-linux-amd64
12faf2ada3e7ea193de8d420a04d6cec46830d8259000ba173784c3f49fe16bf  ccdash-linux-arm64
0591568869344623e5754b573f8506d198fd443756810805bc53f1c79e3650a2  ccdash-darwin-amd64
fa4139c0d5aadd01f8fc0064b541cdf2175ff40d0c4d85b2aaa3aa7aa52ecf39  ccdash-darwin-arm64

Full Changelog

See CHANGELOG.md for complete version history.

v0.7.22

29 Jan 18:01

Choose a tag to compare

v0.7.22: Improved hook reliability and multi-settings support

- Install hooks to ALL settings*.json files (not just settings.json)
- Robust hook scripts with jq fallback to grep/sed
- Better error logging in hooks
- Fixed spinner detection (removed - they persist after work stops)

v0.7.21

29 Jan 13:54

Choose a tag to compare

fix: remove spinner detection from working status

v0.7.20

29 Jan 13:43

Choose a tag to compare

v0.7.20: Improved instance detection and request tracking

Features:
- Track requests with zero tokens for rate limit monitoring (GLM models)
- Add "5 hours" lookback preset for 2400 req/5h rate limit
- Add running process count via pgrep for reliable detection
- Show "tracked/procs" when counts differ to identify detection gaps

Fixes:
- Detect new Claude Code working indicators: (running), spinners (✶, ✻)
- Fix "esc to interrupt" detection without parentheses