BUILD / use-grok-build-agent-dashboard

Build

Use the Grok Build Agent Dashboard across sessions

Use the Grok Build Agent Dashboard across sessions

The Agent Dashboard is a fullscreen overview of every Grok Build session: which agents need input, which are working, and which are done. Open it with Ctrl+\, the /dashboard command, or grok dashboard from the shell.

How rows are grouped

Rows update live and group by state:

State Meaning
Needs input Waiting on you (permission, question, or reply)
Working Actively running a turn
Idle Ready for a new prompt
Inactive Quiet / parked
Completed Finished
Failed Stopped with an error

Press Ctrl+G to group by directory instead of state. Grouping and pins persist under [dashboard] in ~/.grok/config.toml.

Work from the peek panel

Selecting a row opens a peek panel with the agent's latest activity. Type to reply: an idle agent gets the message immediately; a busy one queues it. Answer permission prompts and questions inline with the number keys.

Keys Action
/ Select row
Enter Attach to the session (full details view)
Ctrl+\ Return to the dashboard from a session
Ctrl+[ / Ctrl+] Cycle between sessions
Ctrl+/ Search — a: by agent, s: by state, or plain text
Ctrl+T Pin / unpin
Ctrl+R Rename
Ctrl+X Stop / close (press twice)
Shift+↑ / Shift+↓ Reorder pinned agents
Esc Close peek, then filter, then the dashboard

Start new sessions from the bar

The input bar at the bottom dispatches prompts to new sessions. Ctrl+L changes the working directory for new agents. Ctrl+W toggles whether they start in a git worktree — pair with Use Grok Build worktrees.

Turn the dashboard off

Set enabled = false under [dashboard] in ~/.grok/config.toml, or GROK_AGENT_DASHBOARD=0, to disable the feature.

Pitfalls