0.2.112 — onboarding tutorial, search tool overrides, hooks in config.toml, richer doctor/resume/workflows, and a breaking CLI version-policy split.
Changelog
[changed] CLI version policy now separates soft update floors/ceilings from hard startup requirements.
[new] /tutorial opens an opt-in nine-topic onboarding tour.
[new] tool_overrides / toolOverrides let you set date cutoffs and domain allowlists on the built-in search tools.
[new] Config options to add query parameters or environment-backed headers on custom model providers, and to control which variables reach shell tools.
[new] Hooks can be defined in config.toml / managed_config.toml / requirements.toml (same schema as JSON hook files, additive across layers).
[changed] Terminal and environment fixes are consolidated under /doctor, with clearer guidance; grok doctor fix can repair common tmux clipboard and passthrough problems.
[new] Slash commands can show optional bracket tags (e.g. [new]) via config or remote settings.
[new] Queued prompts offer an [edit] mouse control beside Send now and cancel.
[new] Voice shortcut toggle in settings can disable Ctrl+Space/F8 without turning voice off entirely.
[changed] Image edit can use a remotely configured model slug instead of a hardcoded default.
[changed] Per-provider auth helpers work on Windows and can run from a configurable working directory.
[changed] /resume lists native Grok sessions by default (with a hint when external sessions are hidden); grok --resume accepts session title as well as ID.
[changed] Workflows overlay shows live per-agent progress and follows the active phase; failed workflow runs can be resumed; scratch file limits are higher.
[changed] Marketplace add rejects non-git URLs at add time.
[changed] Clicking the “still running” status opens the tasks pane.
[changed] Web search defaults to grok-4.5.
[fix] File attachments appear correctly when resuming or replaying conversations.
[fix] Remote-client terminal output is recorded so read-file hints and monitors work.
[fix] Background shell commands report real exit codes (no longer always -1).
[fix] Marketplace source refreshes no longer hang the TUI or trap you in the extensions modal.
[fix] Background task tray clears killed tasks and keeps descriptions after reconnect.
[fix] Dashboard overlay returns correctly after forking a dashboard-attached session.
[fix] Linux voice dictation works on PipeWire versions before 1.6.
[fix] Fork from a rewound session copies the correct live-branch history.
[fix] Account pane still shows name and email after the access token expires.
[fix] Voice mode allows editing already-dictated text without closing the mic; dictation text is no longer dropped on Enter-to-send.
[fix] Startup hangs on Linux after concurrent launches or rapid restarts are fixed.
[fix] MCP tools appear without restart after enrolling or updating a managed service; plugin subagents see the same MCP tools as the parent.
[fix] Copy confirmations use shorter success messages.
[fix] Repeated identical tool calls end the turn silently (no stop banner).
[fix] Bash mode (!) shows yellow prefix and action label in minimal mode.
[fix] Parked turns no longer spam duplicate “Worked for” markers in the transcript.
Agent & tools
New slash command: /tutorial.
Search-tool policy via tool_overrides / toolOverrides (date cutoffs, domain allowlists).
Hooks ship from config layers as [[hooks.<Event>]] tables; listed in /hooks with layer provenance (user:, managed:, requirements/…).
Doctor surface covers more terminal/environment repairs, including tmux clipboard/passthrough via grok doctor fix.
Resume UX: native-session default listing, resume-by-title from the CLI.
Workflows: live multi-agent progress, resumable failed runs.
Docs
Hooks user guide and custom-hooks docs cover config-file hooks (TOML shape, additive layering, provenance labels).
shell-README documents [[hooks.<Event>]] in config layers.
Background-tasks guide clarifies the “still running” / waiting status line and interrupt-by-typing behavior.
Under the hood
Package set bumped to 0.2.112 (xai-grok-shell, xai-grok-pager, xai-grok-version, and related bins).
Additional session-end hook and pager endline/park marker coverage in the test suite; GitHub export RPC/workspace pieces landed in-tree.
Upgrade notes
Treat the CLI version policy change as breaking: soft update floor/ceiling and hard startup requirements are now separate — confirm your pinned or packaged version gates still match how you ship grok.
If you distribute hooks organization-wide, you can move them into managed_config.toml / requirements.toml instead of only JSON files; layers combine additively and do not replace each other.
Search behavior may differ where tool_overrides / remote defaults apply; web search’s default model is now grok-4.5.
