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
/workflowsis a different fullscreen surface: it lists live workflow runs, not every agent session. See Create and run a workflow in Grok Build.- Install the CLI first: Install the Grok Build CLI.