Ccdash

ccdash

A lightweight terminal dashboard for Claude Code and Codex CLI — shows token usage, cost, agent session status, and system resources in real time.

Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea).

---

What it shows

**Token panel** — aggregates usage from Claude Code's JSONL logs in `~/.claude/projects` and Codex rollout logs in `~/.codex/sessions/YYYY/MM/DD`. Displays input, output, and cache tokens; total cost; tokens/min rate; and a per-model cost breakdown, color-coded and sorted by spend.

**Session panel** — shows active Claude Code and Codex agent sessions and their current state. Hook-tracked sessions carry a Claude 🤖 or Codex 💻 badge:

Status	Meaning
WORKING	Claude is actively processing a turn
ASKING	Claude asked the human a question, waiting for input
READY	Prompt is idle, waiting for the next message
ACTIVE	User is typing in the session

Session tracking has two modes: tmux pane inspection (automatic) and hook-based tracking (more accurate). Install Claude hooks with `ccdash --install-hooks` or Codex hooks with `ccdash --install-codex-hooks`.

**System panel** — CPU, memory, swap, disk, network I/O, and load average via [gopsutil](https://github.com/shirou/gopsutil).

---

Installation

Pre-built binary

Download the latest release from the [releases page](https://github.com/jedarden/ccdash/releases), make it executable, and move it to your PATH.

Using Go

Requires Go 1.21+.

go install github.com/jedarden/ccdash/cmd/ccdash@latest

From source

git clone https://github.com/jedarden/ccdash.git
cd ccdash
make install

---

Usage

ccdash

Keyboard controls

Key	Action
q / Ctrl+C	Quit
r	Force refresh
h	Cycle help panels (explains each section)
l	Open lookback picker (change the token measurement window)
u	Self-update to latest release (when available)