Features
Agent Dashboard
The dashboard is a fullscreen overview of every 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.
Rows are grouped by state — Needs input, Working, Idle, Inactive, Completed, Failed — and update live. Press Ctrl+G to group by directory instead.
Working with agents
Selecting a row opens a peek panel showing the agent's latest activity. Type to reply: an idle agent receives the message immediately, a busy one queues it. Permission prompts and questions can be answered inline with the number keys. Press Enter to attach to the session in a full details view; Ctrl+\ returns to the dashboard, and Ctrl+[ / Ctrl+] cycle between sessions.
The input bar at the bottom dispatches prompts to new sessions. Ctrl+L changes the working directory for new agents, and Ctrl+W toggles whether they start in a git worktree.
Keys
| Keys | Action |
|---|---|
↑/↓ | Select row |
Enter | Open the selected session |
Ctrl+/ | Search — a:<name> by agent, s:<state> by state, or plain text |
Ctrl+T | Pin / unpin agent |
Ctrl+R | Rename agent |
Ctrl+X | Stop / close agent (press twice) |
Shift+↑/Shift+↓ | Reorder pinned agents |
Esc | Close peek, then filter, then the dashboard |
Grouping and pins persist under [dashboard] in ~/.grok/config.toml. Set enabled = false there, or GROK_AGENT_DASHBOARD=0, to disable the feature.
Last updated: July 4, 2026