Grok Build Updates & Release Notes

• Dashboard directory grouping now shows a header with the folder path and agent count above each folder of agents
• Dashboard location (branch and folder) now sits on the dispatch box top border instead of its own header row
• /resume on the dashboard now lists sessions from every folder, with the current folder and its checkouts first
• Welcome menu now lists Resume session (Ctrl+R) above New worktree (Ctrl+W)
• [ui] simple_mode is retired and no longer has any effect; sessions always open with the prompt focused
• grok doctor and /doctor now point out a leftover [ui] vim_mode key (now [keys] vim) or the retired [ui] simple_mode key in your config
• Quitting Grok returns you to your shell sooner

• Worktree create and fork now list files that could not be copied and any mode changes that were lost
• Vim navigation is now one setting, [keys] vim (off or nav), also set with /vim-mode; the older [ui] vim_mode still works
• Terminal theme now draws a subtle band behind your prompts using the colors your terminal reports
• Mode-switch toast now shows the mode name (Agent, Plan, Ask) in the color of that mode
• Change-directory picker (Ctrl+L on the dashboard) opens with the path field unfocused, like the /resume search
• Image placeholders in the transcript now show whether the actual image was sent or only the text was typed
• Worktree create now fails cleanly instead of falling back when it cannot copy tracked files or runs out of disk space
• Running Grok sessions are no longer broken when an update deletes their binary
• Dashboard model picks now keep their selected context window when spawning the next session
• Send Now prompts and rewound turns now correctly restore and mark any images that were originally sent
• Resumed sessions now show the correct sent or struck-through state for image placeholders

Worktrees also use saved "always allow" answers from the main checkout, so you are not asked again for a tool you already allowed there. Set [features] worktree_inherits_main_approvals = false to turn this off; the main checkout "never allow" answers apply either way

Prompt suggestions follow vim mode: with [ui].vim_mode on, Tab moves focus to the scrollback instead of accepting the suggestion. → or Ctrl+→ accepts a suggestion, and Esc dismisses it

Headless grok -p runs exit when their work is done instead of hanging when a background task or subagent finishes and its output is read in the same turn

The theme picker in Settings restores your previous theme when you leave it any way other than Enter, as /theme already does

Quitting a session with hooks configured is faster

Updates

• /resume search finds sessions from other folders, tolerates typos, and also matches the commands, file paths, and replies in a session
• --permission-mode plan starts the session in plan mode, as documented, instead of the default mode
• The dashboard Ctrl+L folder picker lists up to 50 recent folders instead of 10
• grok --help gives each command and option a one-line summary, and grok help -h and grok help --help print help for the help command itself instead of an error
• /resume search keeps a single typed character literal and matches each typed word at the start of a word, so log fix no longer matches "Blog prefix cleanup"
• Any value of DISABLE_TELEMETRY or DISABLE_ERROR_REPORTING, including 0 and false, turns telemetry and crash reports off

• Untrusted folders run only managed hooks from your organization. User, project, plugin, and agent hooks wait until you trust the folder. Headless sessions treat user hooks as trusted.
• Worktree names typed with Ctrl+W keep Unicode letters such as café, and a name or ref that starts with - is refused.
• Auto mode runs a shell command without review only when every command in it matches an allowlist entry; anything else asks first. Permission rules read each word the way bash passes it to the program.
• /resume loads older sessions when you reach the last row, and shows how many sessions are loaded.
• Auto mode runs make --version, cmake --version, and just --version without asking.
• HTTP connections, including remote MCP servers, accept gzip, brotli, zstd, and deflate compressed responses.
• Plugin install suggestions above the prompt are off when disable_plugins = true is set.
• New worktrees keep tracked files that match .gitignore, and leave out files excluded only by .git/info/exclude or core.excludesFile.
• A new session that fails to start puts what you typed back in the prompt you return to, instead of losing it.
• Web search works from the first turn of a session, and in subagents, when the search model signs in through an external auth provider.
• grok -w, grok worktree create, worktree forks, and subagent worktrees refuse up front with the sandbox refusal message when the sandbox profile does not allow creating worktrees.
• Worktree options are hidden in /fork, /new, and the Welcome screen when the sandbox profile does not allow creating worktrees.
• A worktree name you type that is already taken is refused instead of getting a numbered suffix, and a name whose folder you deleted by hand can be used again.
• Grok on macOS without a GUI session, such as over SSH, no longer hangs on its first modifier-key check.
• Custom models on the Responses API keep the turn going when a web search call starts without an action.
• Shell commands run correctly on zsh when your startup files alias grep or replace run-help.
• Voice dictation preview grows the prompt as you speak and keeps the newest words in view.

Memory always uses the concise MEMORY.md index of topic titles and paths, and /memory lists topics by how often Grok reads them. The [memory_v2] compact_index_enabled setting no longer has an effect

Rex terminal support reports each open session and each running subagent as its own record, so Rex shows what each one is doing. Set children = false under [ui.notifications.program_status] to report only the main status

grok worktree list and grok worktree show mark a worktree whose folder is missing or whose source repository moved, with a hint on how to repair it

Command hooks accept an args list: Grok runs command as one program with those arguments and no shell, and fills hook variables such as $GROK_SESSION_ID in each argument

Plan reviews that open while you are typing keep your text in the review notes, so a typed letter no longer triggers a plan shortcut such as approve

Plan reviews at the end of a turn wait until you close an open /feedback dialog, question, tool prompt, or queued prompt edit

grok -w and Ctrl+W explain that no worktree was made when you run them outside a git repository

/fork keeps the model and effort from the parent session when Grok was started with -m or --effort

Custom models on Chat Completions endpoints no longer fail turns with a tool schema error when MCP servers are connected

Workflow run views hide live status text for each agent on narrower terminals, so agent names are no longer cut off

• Headless mode (grok -p) waits for the follow-up turn that a finished background task starts before exiting, and a --background-wait-timeout that stops pending work exits with an error instead of success
• Cold /resume from the dashboard overlay keeps the overlay attached, so you can still back out with Left or Ctrl+\
• Enter on a highlighted slash command with optional arguments runs the command instead of leaving a trailing space in the composer
• CLI commands such as grok models, grok sessions and grok export no longer crash when their output pipe closes early, such as when piped to head, or when the output device is full
• grok update and grok login no longer crash when stdout or stderr is closed or unwritable

Resume picker finds sessions whose titles contain every word you type, in any order

/resume opens the session directly when the ID or title matches exactly one session, instead of always opening the picker

Dashboard peek text can be selected by dragging over it with the mouse, and the selection is copied to the clipboard when you release

Workflow run views scroll toward newer agents when you wheel down the agent roster, instead of snapping back

Hook spawn failures on Windows name the program that failed to start, such as PowerShell or Git Bash, instead of blaming the hook script

• grok --resume lists matching sessions newest first with when each was last updated, and suggests similar titles when nothing matches</li> <li>Shift+Y in the fullscreen markdown viewer copies the code block under the cursor</li> <li>grok --resume <title> with a title that matches no local session reports the miss right away instead of trying a remote restore and asking you to sign in</li> <li>Esc on the first question in a session opened from the dashboard moves focus to the scrollback, as it does in a standalone session, instead of returning to the dashboard</li> </ul>

Dashboard /loop without a prompt shows its usage instead of starting a new session

grok --resume <title> matches a title whatever separates its words, so fix-login-bug finds "Fix login bug"

[Copy] buttons appear under code blocks in finished replies, labeled with the language or file name of the code

Dashboard peek replies waiting on a clipboard paste are canceled with a toast when you move the peek to another row or press Esc, instead of being sent later

grok worktree rm no longer suggests -f for a worktree that -f would also refuse to remove

Advanced PowerShell inline hooks that read $input run with a warning instead of failing

Hooks that return continue: false stop the turn instead of being ignored

Copy rows under code blocks, tables, and diagrams display correctly after switching between minimal and fullscreen modes

Copying a code block or a whole reply keeps its original tabs instead of turning them into spaces

• /resume takes an optional session id or title and opens the picker filtered to matching sessions
• Pasted Windows line endings reach the model as newlines, markdown images no longer show a stray "!", and dollar amounts that are not math stay plain text
• Write approval cards show a binary or unreadable file as unreadable instead of garbled text
• Prompts you send while a session is resuming at startup are queued and sent once it loads instead of staying in the composer
• A corrupt session list no longer stops new sessions from registering: grok keeps a backup, salvages the rows it can read, and warns you
• Wrapped URLs in shell command descriptions link to the full address on every row
• Worktree forks (grok -w -r or /fork into a worktree) run in and show the worktree path, so a shell command no longer edits the original checkout
• Links are clickable in herdr panes
• Memory search shows the matching part of a long line instead of cutting it off before the match
• /memory skips a symlinked note instead of failing the whole listing
• Startup is faster when TMUX names a tmux server that has stopped
• Failed MCP tool rows wrap the error to the screen width and keep its line breaks
• [skills].ignore matches a symlinked SKILL.md by the folder that holds it
• Failed file reads expand to show why they failed
• Send now (Ctrl+Enter) on a slash command runs or queues it as a command instead of sending it as a prompt
• The idle welcome screen uses less CPU
• Typing in a prompt that holds large pastes is faster, and prompt undo history is capped so deleted pastes no longer stay in memory
• Long sessions use less memory after long replies scroll off screen

• Wrapped shell commands in tool and background-task rows copy back as one line
• /hooks lists load errors from inline hooks and from plugins
• --tools and --disallowed-tools also apply in the interactive TUI
• /goal pauses after three continuations in a row with no tool call; run /goal resume to continue
• Quitting warns when it would stop a running workflow and asks you to confirm with a second quit
• Multi-file edits show how many other files the edit changed
• Worktrees created from a repository subfolder report the repository root as their source in grok worktree list and grok worktree show
• /feedback stays open while you type when a permission request, question, or MCP prompt arrives
• Persistent shell runs your command even when restoring its saved state fails
• /fork is refused while an approval request is open, so the approval keys keep answering that request
• grok --help and grok --version no longer create a .grok folder
• Wrapped URLs in tool headers link to the full address on every row
• /workflow stop and /workflow pause no longer pick a run from a loose fuzzy match, and headless -p runs print each refused approval request to stderr
• Workflow run views list agents outside a declared phase and count only finished agents as done
• Parallel MCP tool calls that ask for input each show their own prompt
• /feedback Drafts load the valid drafts when one saved draft is invalid
• grok sessions list and /resume keep working when one session directory is unreadable
• grok plugin install interrupted mid-clone on Linux no longer leaves a partial folder that blocks the retry
• Hooks you disabled stay disabled when the disabled-hooks file cannot be read
• Edit diffs mark removed and added lines with - and + when color is off
• Session usage keeps every turn when two windows write to the same session
• Failed directory listings expand to show why they failed
• Stdio MCP servers expand a leading ~ in their command and arguments to your home directory
• Editing a queued command such as /compact is refused with a message, so your new text is kept
• /docs opens the exact guide or picker you type
• grok inspect warns when a known [features] key in config.toml has a non-boolean value
• Send now (Ctrl+Enter) no longer answers the stop-subagents panel or an MCP prompt card
• @-mentions reuse the file list until the folder tree changes, so suggestions appear faster

• Added support for OSC 7501 and the Rex terminal
• Expanded tool-call groups stay expanded as new calls join them, and Ctrl+E expands or collapses thinking faster in long transcripts
• Project hooks in a repository subfolder load when you launch inside that folder
• HTTP hooks to localhost work, and bad hook URLs are reported at load time
• Command status-line scripts see the current turn prompt ID and start time while the turn is active
• /model switches that fail no longer change the footer or the saved default model
• Export and copy refuse to overwrite an existing file, and show a clear message
• Shell commands no longer keep running after you quit grok, or after grok receives a signal
• Approval cards for background subagents no longer disappear when the parent turn ends
• grok worktree rm and gc no longer delete a worktree that an open session is using
• Pasted images over 50 MB are rejected with a clear message instead of being dropped silently
• grok -p --effort warns when the model ignores the flag, and refuses invalid effort levels
• Approval notifications name the session that needs approval
• grok worktree rm refuses to delete git repositories, .git folders, or any directory grok did not create
• grep and list_dir report a clear error when a search times out or fails, or the folder cannot be read, instead of returning no results
• Cancelled terminal commands show the command that was stopped
• Wrapped URLs in prompts and quotes link to the complete address
• Restarting after a model switch no longer reverts to the previous model
• Long tool turns that include PostToolUse hook output compact instead of hitting the prompt length limit
• Headless prompts that start with a byte-order mark no longer send that mark to the model, and no longer break JSON prompt files
• MCP tool replies that contain invalid characters no longer cause the call to time out
• Context overflow errors trigger automatic compaction instead of failing the turn
• Inline tags in agent replies no longer break line layout
• /workflow stop picks the correct live run
• Auto-compaction stops after three context refills in a row instead of looping
• Minimal mode shows the permission prompt instead of a hidden plan or cancel panel when both are present
• Approval cards close the block viewer so the card is visible
• The in-session resume picker matches the ungrouped layout on the welcome screen when that layout is configured