agent-dashboard

agent-dashboard

A tmux-integrated TUI and mobile web companion for monitoring and controlling Claude Code agents across sessions. The TUI is built with Bubble Tea and styled with Catppuccin Frappe; the mobile companion is a PWA you run on your local network so you can manage agents from your phone.

https://github.com/user-attachments/assets/01aa0f85-cfd4-4dc3-ac46-651bcfc03f99

Both interfaces read agent state from per-agent JSON files in ~/.agent-dashboard/agents/ (written by the Claude Code adapter in adapters/claude-code/).

Features

TUI (terminal)

• Real-time agent monitoring — agents grouped by state (needs attention, running, completed) with live tmux pane capture
• Subagent tree — expand/collapse/dismiss subagent nodes under parent agents
• Conversation history — timestamped messages with role-based colouring, incremental JSONL parsing
• Diff viewer — GitHub-style split-pane diff with syntax highlighting, smart context collapsing, and sticky function headers
• File change tracking — colour-coded additions, removals, and modifications
• Plan viewer — glamour-rendered markdown plans with syntax highlighting
• Usage dashboard — per-agent token breakdown, 7-day cost chart, cumulative totals persisted to SQLite
• Session creation — create new agent sessions with z-plugin frecency-ranked path autocomplete and skill selection (feature, fix, chore, refactor, investigate, pr, rca)
• ASCII pet — experimental animated red panda companion in the left panel (opt-in via settings)
• Dino runner game — experimental Chrome-style endless runner in the left panel with jump, duck, speed ramp, and score counter (opt-in via settings)
• Quick reply — send free-text responses directly to agent panes
• GitHub PR workflow — open existing PR diff, create new PR, or merge via gh CLI (falls back to browser)
• Status feedback — colour-coded success/error messages in the help bar for user actions
• Help overlay — full-screen keybinding reference grouped by context
• Daily quote — fetched from API Ninjas with fallback to embedded quotes
• Pixel art banner — axolotl rendered with half-block Unicode characters
• Singleton lock — prevents multiple dashboard instances from running simultaneously
• Semantic versioning — version injected at build time via -ldflags

Mobile remote control

A companion PWA (cmd/web/) for managing agents from your phone over your local network:

• Agent list and detail views — same state grouping as the TUI, with conversation timeline and diff viewer
• Full remote control — approve/reject permissions, reply to questions, send numbered options, stop agents, open PRs, merge, and close — all from your phone
• Session creation — create new agent sessions with z-plugin suggestions and skill selection
• Usage dashboard — token breakdown and cost tracking
• Google OAuth — optional single-user authentication so only you can access the dashboard
• Installable PWA — add to home screen for a native app feel with offline caching via service worker

Prerequisites

Dependency	Required	Purpose
tmux	Yes	Agent pane management and live capture
Claude Code	Yes	The agents this dashboard monitors
Node.js 18+	Yes	Claude Code adapter hooks
git	Yes	Diff viewer, branch detection
GitHub CLI (gh)	No	Detects existing PRs so g opens the diff page instead of creating a new PR
z (zsh plugin)	No	Frecency-ranked directory suggestions when creating sessions

Install

Step 1: Install the binary

Download the pre-built binary from the latest GitHub Release:

curl -fsSL https://raw.githubusercontent.com/bjornjee/agent-dashboard/main/install.sh | sh

The installer downloads the binary for your platform, verifies its SHA256 checksum, and installs it to ~/.local/bin/agent-dashboard. No Go toolchain required.

Or build from source (requires Go 1.26+):

git clone https://github.com/bjornjee/agent-dashboard
cd agent-dashboard
./install.sh --build

Step 2: Register the marketplace and install the plugin

In any Claude Code session, run:

/marketplace add bjornjee/agent-dashboard
/plugin install agent-dashboard@agent-dashboard

Then restart Claude Code sessions for hooks and skills to take effect.

Uninstall

Step 1: Remove the plugin

In any Claude Code session, run:

/plugin uninstall agent-dashboard@agent-dashboard
/marketplace remove agent-dashboard

Step 2: Remove the binary and state