docs/start here/overview

Agent Dash

A TUI dashboard for your Claude Code sessions, running in tmux or closed

Agent Dash is a terminal dashboard for Claude Code sessions. It lists the sessions running in your tmux server next to the ones that aren't, so a session you closed yesterday is one keypress from running again.

Built with Ratatui, Crossterm, and Tokio.

Features

How it works

Every two seconds Agent Dash finds the tmux panes running claude and reads the ~/.claude/sessions/<pid>.json file Claude Code writes for each process. That file carries the session ID, working directory, title, and busy/idle status. Agent Dash needs that file: a claude pane without it is not listed. See Claude Code for the details and for how a closed session is told apart from a crashed one.

The preview uses a FIFO pipe for low-latency updates, with tmux capture-pane polling as the fallback. Plan and Ask prompt state is read from the last line of the pane.