Grok Build
BetaThe latest fixes, features, and improvements shipping to Grok Build.
Latest v0.2.73·Jun 28, 2026
grok agent stdio hangs on Windows when used with persistent clients such as VS Codegrok wrap to run any command with local clipboard supportCtrl+4 now toggles the prompt queue on local macOS VS Code terminals/recap and return-from-away) now show the full summary instead of being cut off mid-sentencegrok agent stdio startup hangs on Windows when used with persistent clients such as VS Code or grok-desktop/mcps list no longer shows stale disabled entries when managed gateway tools are enabledr in scrollback no longer accidentally rewinds the sessionCtrl+X on terminals that cannot deliver Ctrl+.Shift+Tab, collapses the Inactive section by default, and hides older idle agents behind a "N more" row--json-schema to grok -p and receive a validated JSON object instead of free textCtrl+L now interjects mid-turn in VS Code, Cursor, Windsurf, and Zed terminals/context command now reports the same number of tool definitions that are actually sent to the model/sessions on the agent dashboard no longer freezes the interfaceGROK_AGENT=1 so host tools can tell them apart from interactive shells/resume now selects the correct model when a saved model name is ambiguous--json-schema flag for headless mode to constrain model output to a supplied JSON Schema/rename now persists correctly and appears in /session-info even after auto title generation or resume**/*.pem in addition to exact pathsXAI_API_KEY present no longer lose refresh on idlelist_dir now reliably shows all immediate child directories even inside large monorepos/model dropdown no longer opens the wrong sessionCtrl+[ / ] now switches from the session you are currently viewingCtrl+R) now shows the complete recent list instead of a scrambled partial onegrok -w --ref <branch> now creates worktrees based on the specified ref instead of HEADCtrl+L to change location, or Ctrl+W to dispatch new agents into fresh git worktrees/recap now appears as a collapsible tool-style block with a loading spinner while generating/usage command and credit warnings are now hidden for API-key authentication/usage warnings now correctly reflect prepaid credits and auto top-up status/recap is now available by default — it generates a quick summary of your current session so you can catch up on what’s happened so far/goal slash command now appears in the menu on the welcome screen before any prompt is sent when the feature is enabled/usage and warnings now match backend flooring and show pay-as-you-go limits when applicable/usage now shows prepaid credits balance and auto top-up statusconfig.toml under the [features] table/goal options (toggles, limits, role models) are now configurable together in a [goal] table--disable-web-search is now honored in grok -p and grok agent; auxiliary model routing respects catalog overrides/resume now shows sessions from your current working directory’s repo at the top of the listconfig.tomlCmd+Backspace now deletes only from the cursor to the start of the line instead of clearing the whole prompt/btw answer panel is visibleagent command is now kept in sync with grok after running grok updategrok -p) runs now wait for background tasks and subagents to finish before exitinggrok plugin install <name> now resolves plugins from registered marketplaces instead of only local paths< and > in responses and tool output[ in the pager prompt no longer appears delayedresume_from now continues a finished sub-agent in place instead of forking a new conversationgrok sessions delete <id> now lets you permanently remove a session from the CLIlist_dir now shows more relevant files when a large directory appears early in alphabetical ordergrok quit no longer hangs when background git or network tasks are slowlist_dir now gives clearer guidance when a directory is too large, using the actual tool names available in your sessionCtrl+Enter now sends the prompt when the agent is idle (same behavior as Enter)resume_from now correctly continues a sub-agent in the same working directory it was using before/resume, grok sessions list) are now sorted by the same activity time shown in the UI--hunk-tracker-mode, GROK_HUNK_TRACKER, or configCtrl+X now stops running turns or closes sessions from inside the agent detail viewShift+Enter fails because kitty keyboard protocol is disabled\?\ prefixesCtrl+V) now works for images on pure Wayland sessions/sessions no longer crash on narrow terminalsptyctl resize now correctly notifies the child processEEXIST errorsgrok dashboard now reliably opens the dashboard instead of silently falling through to a normal sessionweb_fetch errors on GitHub hosts now recommend using the gh CLI when internal access is blockedCtrl+C cancels now complete in under 50 ms instead of blocking for secondsgrok mcp add now accepts positional arguments (e.g. grok mcp add filesystem -- npx ...), supports --scope project, and adds -e/-H flags for env/headersEnter and number-key shortcuts/code-review slash command now ships with the CLI and is always availablegrok update no longer downloads the same binary twice when multiple updaters or leader checks run concurrently/compact are now shown verbatim so the model can reference them correctly in later tool calls/ while scrollback is focused now focuses the prompt and opens the slash-command dropdown~/.grokgrok outside a project directoryCtrl+W in the prompt now deletes whole words like bash instead of stopping at punctuationqstateDiagram mermaid blocks now render as Unicode diagrams instead of source fallbackgrok --resume now correctly finds the real session instead of failing on empty image-only foldersstateDiagram Mermaid blocks now render as diagrams instead of source fallbackgrok --resume failing on empty image-only session folders left by cross-directory pastes& groups, circle/cross endings and self-loopsgrok --resume failing on empty image-only session folders left by cross-directory pastesK/J keys snap the viewport to the top of previous or next assistant responsesJ/K vim mode navigates between assistant responses in scrollbacksequenceDiagram mermaid blocks render as Unicode lifeline diagrams instead of source fallbackask_user_question tool can now be enabled in allowlists without requiring plan-mode toolsShift+Tab mode cycling works again in the agent viewCtrl+C now cancels a blocking grok update cleanly instead of leaving an orphaned downloadgrok --debug now produces per-session log files under ~/.grok/debug/ even with a leader processrun_terminal_cmd can stream live stdout/stderr chunks when the workspace flag is enabled/session-info now displays the current turn index& operator is now allowed by default in terminal commands& rejection messages now correctly name the real parametersgrok update now restarts any older running leader so all clients get the new binaryweb_search and x_search tools from the parent sessiongrok login now defaults to device code flow, which works reliably in SSH, WSL, VPN, and browser-restricted environments/rewind before a compaction boundary no longer leaves later prompts in contextread_file are now downscaled even when small in bytes but large in pixels& are no longer incorrectly rejected by run_terminal_cmdpython -c save-to-file reminder now suggests correct commands on Windowsgrok agent --leader without forced interactive login or timeoutscmd.exe no longer falsely reject commands containing &web_fetch no longer crashes the CLI on pages whose root element matches a cleaning selector/resume history pickerimage_to_video and reference_to_video tools[Image #N] attachment references in image_editEnter for Search and ListDir blockssessionId + bound per-server init/btw overlay panel<analysis> block).mcp.json and plugin.jsongrok inspect/loop interval from the request instead of hardcoded parsing--permission-mode acceptEdits to auto-approve editsconfig.toml--permission-mode override the permission_mode setting from config.toml/loop, monitor, tag colorsShift+Tab cyclesCtrl+V image paste/context always showed "Auto-compact at 85%"Left/Right arrows switch tabs in extensions modalUp/Down arrows at list edges focus search inputFocusGained8×8 images on the clientARM64 DLL_NOT_FOUND/rewind menu is open/rewindtimeout_ms promptingUp/Down in slash menu and history searchCtrl+Delete on WindowsCtrl/Alt+V image inputCtrl+Enter / Ctrl+;read_file tool calls and pass as multimodal vision tokens/login command to reauth from inside the TUI/usageCmd+A in prompt to select all text in Ghosttydefault_modeltmux-inside-ssh copy/paste issuesconfig.toml so it survives restartgt and git in /execute-planShift)!Shift+Enter with Alt+Enter on VTE-based terminals (GNOME Terminal, Ptyxis, kgx, Tilix, etc.)search_replace, write_file, and run_terminal_command calls on scrollbackset_images byte-length collision losing chipsread_file duplicate-read check that breaks after compactionCtrl+X as default shortcuts-help binding on Windowsulimit on macOS and Linux, preventing ENOSPC errors from bricking the CLI/exportgrok -w crash when git index is empty/config-agents modalUTF-8 truncation in tool-call output causing crashesCmd+Click on wrapped linkshookSpecificOutput.tool_input overridex86_64 (Intel) supportARM64 (aarch64) supportShift+Enter newline insertion on Windows TerminalSpace / Enter / click toggle sections in shortcuts help modalread_filecwd for CJK characters to fix path references<user_guide> system promptReadTool blockstderr to /dev/null to fix incorrect TUI text interleavinguse_tool output limit to 20 KBread_file (images and PDFs) directly in tool-result messageOSC9 bug fixesQWERTZ AltGr on WindowsBM25 queriesbash, zsh, and fish/tmp instead of writing inline Python scripts