Patch release focused on Agent Dashboard UX (header, directory picker, worktree toggle) plus clearer headless/background and auth tooling, with login pulled into its own subsystem.
Changelog
[changed]Agent Dashboard layout and controls — The overview header now shows the git branch and working directory for new agents, with state-count chips (awaiting / working / idle). Click the location or press Ctrl+L (or /cd <path> from the dispatch box) to choose another directory. An actions row adds + New Agent, Open Previous (/resume, workspace dashboard), and a worktree toggle (Ctrl+W): with worktree mode on in a git repo, the next dispatch creates the agent in a fresh worktree.
[changed]grok dashboard help — Documents that the dashboard lists every session (top-level and subagents), and that it can be turned off with [dashboard].enabled = false in ~/.grok/config.toml or GROK_AGENT_DASHBOARD=0.
[changed]Foreground bash / command timing — Foreground shell commands block the tool for at most about 15 seconds; if still running they are moved to the background (with a task id) rather than treated as a hard kill at that point. An explicit timeout remains a kill deadline only while the command is still in the foreground; once backgrounded, the process runs until it exits (background cap 10h) unless you stop it.
[changed]--leader-socket — Help text explains using a custom socket so a local or branch build can run an isolated leader without colliding with the default ~/.grok/leader.sock. Prefer ~/.grok/leader-*.sock so grok leader list / kill still discover it.
[changed]--todo-gate — Clarified as session-scoped (not persisted) and highest precedence over remote todo_gate_enabled and the built-in default (false).
[changed]Flag and completion copy — Shell completions (zsh, fish, elvish, PowerShell) and related help for --background-wait-timeout, --no-wait-for-background, --minimal, and dashboard were brought in line with the above.
[changed]Auth debug logging — Docs now use the xai_grok_login log target (for example RUST_LOG="info,xai_grok_login=debug") instead of xai_grok_shell::auth.
Under the hood
Login and credential handling live in a dedicated xai-grok-login stack (OIDC, device code, refresh, storage, recovery) rather than inside the shell auth tree; image handling is split into xai-grok-image, with additional grove/git and build-task wake / subagent finish plumbing.
Runtime settings fetch can consult a /v1/user profile endpoint alongside existing models/settings traffic.
Upgrade notes
If you debug authentication with RUST_LOG, switch any xai_grok_shell::auth=… filters to xai_grok_login=….
To keep the Agent Dashboard from opening, set [dashboard].enabled = false or GROK_AGENT_DASHBOARD=0.
