Dashboard
flock dashboard is the ratatui control tower over the in-tree multiplexer — the daily-driver view of agents, pressure, pane topology, and evolution archive.
Launch
flock multiplexer ensure
flock dashboard
Defaults:
- Socket:
~/.config/flock/flock.sock(override with--socket) - Episodes:
.flock/episodes - Archive:
.flock/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/flock/statusline.json on each refresh. MCP tool flock_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 flock-dashboard --test integration
Included in ./scripts/verify.sh.