Dashboard
castellan dashboard is the ratatui control tower over the in-tree multiplexer — the daily-driver view of agents, pressure, pane topology, and evolution archive.
Launch
castellan multiplexer ensure
castellan dashboard
Defaults:
- Socket:
~/.config/castellan/castellan.sock(override with--socket) - Episodes:
.castellan/episodes - Archive:
.castellan/archive
Keybindings
| Key | Action |
|---|---|
j / k | Select agent up/down |
Enter | Attach to selected pane (Ctrl+Q to detach) |
r | Refresh agents + layout snapshot |
q | Quit |
Headless observability
The dashboard writes ~/.config/castellan/statusline.json on each refresh. MCP tool castellan_read_statusline (see MCP tools) reads this snapshot for external monitors.
CI smoke
Dashboard client code is tested against a mock Unix socket:
cargo test -p castellan-dashboard --test integration
Included in ./scripts/verify.sh.