Index
Features
Auto and always-approve
SpaceXAIAsk (default) prompts for anything not already allowed. Auto uses a classifier to auto-approve safe tools. Always-approve skips permission prompts; deny rules and PreToolUse hooks still apply. Shift+Tab cycles Normal → Plan → Auto → Always-approve. Allow/deny rules in [permission] or --allow/--deny; deny wins.
Headless and scripting
SpaceXAIRun without the TUI via grok -p. Optional --output-format streaming-json for scripts, automations, or other apps.
Agent Client Protocol
SpaceXAIUse Grok Build through the Agent Client Protocol (ACP) in other apps.
Plugins
SpaceXAIPlugins add skills, agents, hooks, MCP servers, and LSP servers from ./.grok/plugins/, ~/.grok/plugins/, marketplace installs, [plugins] paths, or --plugin-dir. The TUI extensions modal opens from /plugins, /hooks, /skills, or /mcps.
Marketplaces
SpaceXAITUI Marketplace tab installs plugins from [[marketplace.sources]] in ~/.grok/config.toml and ~/.grok/plugins/known_marketplaces.json.
Release channels
SpaceXAIInstaller respects GROK_CHANNEL=stable|alpha|enterprise (default stable). The welcome screen shows the active channel. Failed channel updates suggest the matching reinstall command. Persist the choice in ~/.grok/config.toml under [cli] channel.
Sessions
SpaceXAIEvery conversation is saved under ~/.grok/sessions/. Resume with /resume, grok --resume, or grok -c. /fork branches a peer session; /rewind restores files and truncates the conversation. grok sessions list/search/delete and grok export manage them.
Worktrees
SpaceXAIIsolated git checkouts under ~/.grok/worktrees/<repo>/<name> so parallel agents do not overwrite each other. Start with grok -w, /fork --worktree, or Ctrl+W on the dashboard. Persist until grok worktree rm or gc.
Sandbox
SpaceXAILimits what an approved tool call can read, write, and reach on the network (Landlock on Linux, Seatbelt on macOS). Off by default. Profiles: off, workspace, devbox, read-only, strict. Enable with grok --sandbox, [sandbox] profile, or GROK_SANDBOX.
Agent Dashboard
SpaceXAIFullscreen overview of every session (needs input, working, idle, completed, failed). Open with Ctrl+\, /dashboard, or grok dashboard. Reply or answer permission prompts inline; Ctrl+W starts new agents in a worktree.
Background tasks
SpaceXAIRun commands, subagents, and monitors while the conversation continues (/tasks, Ctrl+G). /loop repeats a prompt on an interval (max 50, expire after 7 days). Monitors notify on each script line. Ctrl+; or /queue lists prompts queued behind the running turn.
Theming
SpaceXAITUI themes via /theme or [ui] theme in ~/.grok/config.toml. Built-ins include GrokNight (default), GrokDay, TokyoNight, RosePineMoon, and OscuraMidnight. theme = auto follows OS light/dark.
CLI
CursorClone and push Origin repos, drive agents, and script workflows from the terminal.
13 of 89