Grok Build 命令地图最后核对:2026 年 7 月 16 日 · v0.2.101

Grok Build 完整命令速查表

从首次启动到 Headless 自动化、权限、Worktrees、MCP、插件、记忆和所有固定 TUI 命令,一页完整收录。

17
个完整章节
CLI
CLI 与全局参数
TUI
固定 TUI 命令
CI
自动化组合

搜索原文中的每条命令、示例、表格与注意事项。

截至 2026 年 7 月 16 日,Grok Build 官方最新版本是 v0.2.101,发布于 7 月 13 日。需要注意的是,官方 CLI Reference 只列出“最常用”的参数;插件、Skills、实验功能和账号权限还会动态增加命令,因此不存在一张永久不变的绝对完整表。下面汇总的是:官方文档中的固定命令 + 近期 Changelog 新增命令 + 条件启用命令。([SpaceXAI][1])

先用这几个命令检查你本地安装版本的真实命令集:

bash
grok version
grok --help
grok <subcommand> --help

进入 Grok Build 后:

text
/help

也可以直接输入 / 打开当前版本的命令菜单。


01

安装、启动与登录

涵盖 macOS、Linux、WSL、Windows 安装,在项目或指定目录启动,以及 OAuth、设备验证与 XAI_API_KEY 认证。

1. 安装

macOS、Linux、WSL:

bash
curl -fsSL https://x.ai/cli/install.sh | bash

Windows PowerShell:

powershell
irm https://x.ai/cli/install.ps1 | iex

2. 启动

bash
cd your-project
grok

指定工作目录启动:

bash
grok --cwd /path/to/project

使用 API Key:

bash
export XAI_API_KEY="xai-..."
grok

3. 登录和退出

bash
grok login
grok login --device-auth
grok logout

--device-auth 适合 SSH、服务器、容器、WSL 等不方便打开浏览器的环境。(SpaceXAI Docs)

02

全部顶层 CLI 子命令

完整列出交互工作、认证、检查、模型、MCP、插件、会话、导入、记忆、Worktrees、Dashboard、ACP、wrap、更新、补全与托管设置等顶层命令。

以下是当前官方 CLI Reference 列出的顶层命令。(SpaceXAI Docs)

命令作用
grok启动交互式终端界面
grok login登录 Grok Build
grok logout退出并清除缓存凭证
grok inspect查看当前目录加载的配置、规则、Skills、插件、Hooks 和 MCP
grok models列出当前可用模型
grok mcp ...管理 MCP Server
grok plugin ...管理插件
grok plugin marketplace ...管理插件市场源
grok sessions ...查看、搜索和删除会话
grok export ...导出会话记录
grok import ...导入 Claude Code 会话
grok memory clear ...清除跨会话记忆
grok worktree ...管理 Grok 创建的 Git Worktree
grok dashboard打开 Agent Dashboard
grok agent stdio以 ACP Agent 模式运行
grok wrap ...包装 SSH、Docker、kubectl 等终端命令
grok update检查或安装更新
grok version显示版本
grok completions ...生成 Shell 自动补全
grok setup获取并安装托管配置
03

诊断、模型与配置命令

检查实际生效的规则与扩展、列出和选择可用模型、调整 effort、查看版本、生成 Shell 补全并安装组织托管配置。

grok inspect

查看 Grok 在当前目录实际发现了哪些配置:

bash
grok inspect
grok inspect --json

输出通常包括:

  • 配置文件来源
  • AGENTS.mdCLAUDE.md
  • Skills
  • 插件
  • Hooks
  • MCP Servers
  • Claude、Cursor、Codex 兼容配置
  • 当前认证和模型配置

这是排查“为什么某个 Skill、MCP 或规则没有生效”时最重要的命令。

grok models

bash
grok models

查看当前账号、API Key 或自定义模型端点能够访问的模型。

启动时指定模型:

bash
grok -m <model-id>
grok --model <model-id>

交互界面切换模型:

text
/model <model-id>
/m <model-id>

grok version

bash
grok version

grok completions

bash
grok completions bash
grok completions zsh
grok completions fish

grok setup

bash
grok setup

主要用于获取和安装组织托管的 Grok Build 配置。(SpaceXAI Docs)

04

Headless 与脚本命令

以 plain、JSON、streaming JSON 或 JSON Schema 执行单次任务,在 CI 关闭更新检查,并通过 ACP stdio 集成。

1. 单次执行

bash
grok -p "Explain this repository"

完整形式:

bash
grok --single "Explain this repository"

-p--single 让 Grok 执行一次任务后退出,适合脚本、CI、机器人和自动化。([SpaceXAI Docs][4])

2. 输出格式

bash
grok -p "List all TODO comments" --output-format plain
grok -p "List all TODO comments" --output-format json
grok -p "Explain the architecture" --output-format streaming-json

支持:

格式说明
plain普通可读文本
json任务结束时输出一个 JSON 对象
streaming-json按行持续输出 JSON 事件

3. JSON Schema 输出

bash
grok -p "Analyze this project" \
  --json-schema '{"type":"object","properties":{"language":{"type":"string"}},"required":["language"]}'

--json-schema 会要求 Headless 模式返回符合指定 Schema 的 JSON,而不是自由文本。([SpaceXAI][1])

4. CI 中关闭更新检查

bash
grok --no-auto-update -p "Run the test suite"

CI 常用组合:

bash
grok \
  --no-auto-update \
  --always-approve \
  --output-format json \
  -p "Review this pull request"

5. ACP Agent 模式

bash
grok agent stdio

该模式通过 stdin/stdout 使用 JSON-RPC,适合 IDE、编辑器或其他 Agent 客户端集成。(SpaceXAI Docs)

05

CLI 全局参数

完整参数矩阵涵盖会话、目录、模型、推理强度、权限、allow/deny、Sandbox、Prompt、工具、功能开关与终端显示。

1. 会话和目录参数

参数作用
--cwd <PATH>设置工作目录
-r, --resume [<ID>]恢复指定会话;省略 ID 时恢复最近会话
-c, --continue继续当前目录最近的会话
-s, --session-id <UUID>给新会话指定 UUID
--fork-session恢复会话时创建一个新分支会话
-w, --worktree [<NAME>]在新 Git Worktree 中启动
--ref <REF>指定 Worktree 基于哪个分支、标签或 Commit

注意:--session-id 主要是给新会话命名,不等同于恢复旧会话;恢复旧会话优先使用 --resume。([SpaceXAI Docs][3])

2. 模型与推理参数

参数作用
-m, --model <MODEL>指定模型
--effort <LEVEL>设置推理强度
--reasoning-effort <LEVEL>--effort 的别名
--max-turns <N>限制 Agent 最大执行轮数

不同模型可用的 effort 等级可能不同,使用:

bash
grok models

或者在界面里运行:

text
/effort

查看当前可选级别。--reasoning-effort 从 v0.2.89 开始与 --effort 等价。([SpaceXAI][1])

3. 权限参数

参数作用
--always-approve自动批准所有工具调用
--yolo--always-approve 的别名
--permission-mode <MODE>指定权限模式
--allow <RULE>添加允许规则
--deny <RULE>添加拒绝规则
--sandbox <PROFILE>启用沙箱
--no-ask-user禁用 Agent 主动询问用户
--dangerously-skip-permissionsClaude Code 兼容别名

--permission-mode 支持的 Headless 模式包括:

行为
default使用默认权限行为
dontAsk没有明确允许规则的操作直接拒绝
acceptEdits自动批准文件编辑,Shell 命令仍询问
bypassPermissions跳过权限检查
plan计划模式

示例:

bash
grok -p "Review the API changes" \
  --permission-mode dontAsk \
  --allow 'Bash(git *)' \
  --allow 'Bash(gh *)' \
  --allow 'Read' \
  --allow 'Grep' \
  --deny 'Bash(rm -rf *)'

支持的权限过滤器包括:

text
Bash
Edit
Read
Grep
MCPTool
WebFetch

例如:

bash
--allow 'Bash(git *)'
--allow 'Edit(**/*.ts)'
--allow 'MCPTool(linear__*)'
--deny 'Edit(**/.env)'

拒绝规则优先级高于允许规则。([SpaceXAI Docs][5])

4. Sandbox 参数

bash
grok --sandbox off
grok --sandbox workspace
grok --sandbox read-only
grok --sandbox strict
grok --sandbox my-custom-profile

常见配置:

Profile适用场景
off不启用沙箱
workspace日常开发,只允许写当前工作区等位置
read-only代码审计、只读检查
strict不可信仓库和高安全环境
devbox云端开发环境
自定义名称sandbox.toml 读取自定义 Profile

沙箱在进程启动时应用,因此不能在同一个进程中途完全撤销。([SpaceXAI Docs][5])

5. Prompt 和工具参数

参数作用
--rules <TEXT>向系统提示词附加规则
--system-prompt-override <TEXT>完全替换系统提示词
--tools <LIST>指定允许使用的内置工具
--disallowed-tools <LIST>移除指定工具
--allowedToolsClaude Code 兼容别名
--disallowedToolsClaude Code 兼容别名
--append-system-promptClaude Code 兼容别名
--system-promptClaude Code 兼容别名

示例:

bash
grok \
  --rules "Do not modify generated files. Run tests after every change." \
  -p "Refactor the authentication module"

6. 功能开关参数

参数作用
--no-plan禁用计划功能
--no-subagents禁用子 Agent
--no-memory禁用记忆
--disable-web-search禁用联网搜索
--experimental-memory启用跨会话记忆
--oauth欢迎页登录时强制使用 OAuth
--plugin-dir <PATH>加载额外插件目录
--hunk-tracker-mode <MODE>控制或完全关闭代码 Hunk Tracker

--hunk-tracker-mode 属于较低层级的版本化参数,具体可用值应以本地 grok --help 为准。(SpaceXAI Docs)

7. 界面和显示参数

参数作用
--no-alt-screen不占用终端备用屏幕,以内联方式运行
--minimal启动简洁终端显示模式
--fullscreen强制启动全屏 TUI
--no-auto-update关闭本次运行的自动更新检查

--minimal--fullscreen 的选择会被记住,之后直接运行 grok 时会继续使用。(SpaceXAI)

06

会话管理命令

恢复或继续会话、列出/搜索/删除历史、导出到文件或剪贴板、导入 Claude Code 会话,以及在脚本中获取 session ID。

CLI 命令

bash
grok --resume <session-id>
grok --resume
grok -c

会话管理:

bash
grok sessions list
grok sessions search "authentication"
grok sessions delete <session-id>

导出:

bash
grok export <session-id>
grok export <session-id> output.md
grok export <session-id> --clipboard

导入 Claude Code 会话:

bash
grok import
grok import <target>
grok import <target1> <target2>

Headless 获取新会话 ID:

bash
SESSION_ID=$(
  grok -p "Start the refactor" \
    --output-format json |
  jq -r '.sessionId'
)

grok -r "$SESSION_ID" -p "Continue and run tests"

(SpaceXAI Docs)

07

Git Worktree 命令

启动隔离的 Worktree 会话、区分命名语法、查看或移除托管 Worktree、预览删除并清理缺失或过期记录。

启动 Worktree 会话

bash
grok -w
grok --worktree
grok --worktree=feat "Refactor module X"
grok -w --ref main "Fix the flaky test"
grok -w -r <session-id>

注意下面两种写法的差异:

bash
grok --worktree=feat "Refactor module X"

feat 是 Worktree 名称。

bash
grok --worktree feat

某些解析场景下,feat 可能被视作 Prompt,因此建议显式使用等号。

管理 Worktree

bash
grok worktree list
grok worktree ls
grok worktree show <id>
grok worktree rm <id>
grok worktree rm <id1> <id2>
grok worktree rm <id> --dry-run
grok worktree gc
grok worktree gc --max-age 7d
命令作用
list / ls列出 Grok 管理的 Worktree
show查看一个 Worktree 的详细信息
rm删除一个或多个 Worktree
rm --dry-run只预览将删除哪些内容
gc清理目录已不存在的记录
gc --max-age 7d清理闲置超过七天且未被使用的 Worktree

(SpaceXAI Docs)

08

MCP 命令

列出 MCP Server,添加 stdio 或 HTTP transport,设置可重复 Header 与环境变量,选择项目范围、移除 Server 并运行 doctor 诊断。

1. 查看 MCP Server

bash
grok mcp list
grok mcp list --json

2. 添加本地 stdio MCP

bash
grok mcp add filesystem -- \
  npx -y @modelcontextprotocol/server-filesystem /path/to/dir

-- 后面的内容是启动 MCP Server 的真实命令。

3. 添加远程 HTTP MCP

bash
grok mcp add \
  --transport http \
  linear \
  https://mcp.linear.app/mcp

4. 添加带 Header 的 MCP

bash
grok mcp add \
  --transport http \
  api \
  https://mcp.example.com/mcp \
  --header "Authorization: Bearer ${API_TOKEN}"

Header 可以重复指定:

bash
grok mcp add \
  --transport http \
  example \
  https://example.com/mcp \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "X-Team-ID: ${TEAM_ID}"

5. 项目级 MCP

bash
grok mcp add \
  --scope project \
  filesystem -- \
  npx -y @modelcontextprotocol/server-filesystem .

这会写入项目的:

text
.grok/config.toml

而不是用户全局配置。

6. 删除与诊断

bash
grok mcp remove <name>
grok mcp doctor
grok mcp doctor <name>
grok mcp doctor --json
grok mcp doctor <name> --json

相关参数还包括:

text
-e
-H
--header
--transport
--scope project

其中 -e 用于传递环境变量,-H 是 Header 的短参数。(SpaceXAI Docs)

09

插件与 Marketplace 命令

列出、安装、卸载、更新、启用、禁用、查看和验证插件,并管理远程或本地 Marketplace 来源。

插件命令

bash
grok plugin list
grok plugin install ...
grok plugin uninstall ...
grok plugin update ...
grok plugin enable ...
grok plugin disable ...
grok plugin details ...
grok plugin validate ...

作用分别是:

子命令作用
list查看已发现或安装的插件
install安装插件
uninstall卸载插件
update更新插件
enable启用插件
disable禁用插件
details查看插件详情
validate验证插件结构与配置

Marketplace 命令

bash
grok plugin marketplace list
grok plugin marketplace add ...
grok plugin marketplace remove ...
grok plugin marketplace update ...

Marketplace Source 可以是配置的远程源,也可以是本地目录。由于不同来源接受的参数形式可能不同,应通过以下命令确认:

bash
grok plugin install --help
grok plugin marketplace add --help

插件可以提供额外的 Skills、Agents、Hooks、MCP Servers、LSP Servers 和 Slash Commands。(SpaceXAI Docs)

10

更新命令

检查更新、安装指定版本,或在 Alpha 与 Stable 渠道之间切换。

bash
grok update
grok update --check
grok update --version <VERSION>
grok update --alpha
grok update --stable

示例:

bash
grok update --check
grok update --version 0.2.101
grok update --alpha
grok update --stable
参数作用
无参数更新到当前渠道的最新版本
--check只检查,不安装
--version <V>安装指定版本
--alpha切换或安装 Alpha 渠道
--stable切换或安装 Stable 渠道

(SpaceXAI Docs)

11

终端代理命令 grok wrap

包装 SSH、Docker、kubectl 命令,将远程 OSC 52 剪贴板内容转发到本机;该功能目前仍为实验性质。

bash
grok wrap <command...>

常见用法:

bash
grok wrap ssh user@host
grok wrap docker exec -it container bash
grok wrap kubectl exec -it pod-name -- bash

它会在本地 PTY 中运行目标命令,接收远程程序产生的 OSC 52 剪贴板内容,并转发到本机剪贴板。

特别适合:

  • SSH 中运行 Grok
  • Docker 容器中运行 Grok
  • Kubernetes Pod 中运行 Grok
  • 解决远程复制无法进入本地剪贴板的问题

该功能目前仍被官方标记为实验性质。(SpaceXAI Docs)

12

全部固定 TUI Slash Commands

完整固定 TUI 命令,涵盖帮助、会话、Context、历史、模型、权限、计划、目标、后台任务、媒体、UI、诊断、扩展、记忆、账号、隐私、反馈与版本信息。

下面的命令是在进入 grok 交互界面后输入的。

1. 基础与导航

命令作用
/help打开命令和快捷键帮助
/docs打开官方使用指南,可按标题跳转
/home返回欢迎页
/quit退出
/exit/quit 的别名
/new新建会话
/clear/new 的别名

/docs 是 v0.2.87 新增命令,因此尚未出现在较早的 Modes 页面中。([SpaceXAI Docs][10])

2. 会话命令

命令作用
/resume恢复历史会话
/sessions打开会话或 Agent Dashboard
/fork从当前上下文创建一个平行会话
/fork --worktree在独立 Worktree 中 Fork
/fork --no-worktreeFork 但不创建 Worktree
/rename <title>重命名当前会话
/title <title>/rename 的别名
/share生成当前会话分享链接
/session-info查看会话信息
/export导出当前会话
/recap手动生成当前会话总结

新版 /sessions 会直接打开 Agent Dashboard,而不再只是简单的历史会话选择器。([SpaceXAI Docs][10])

3. 上下文与历史命令

命令作用
/context查看 Context 使用情况
/compact [说明]压缩会话上下文
/rewind回退到之前的某个用户回合并恢复文件状态
/copy [N]复制最近或倒数第 N 条回复
/find搜索当前会话 Scrollback
/history搜索历史 Prompt
/transcript$PAGER 中查看完整 Transcript

示例:

text
/compact Preserve the API design decisions and unresolved bugs
/copy
/copy 2

/history 是较新版本新增的 Prompt 历史搜索命令。([SpaceXAI Docs][10])

4. 模型与推理命令

命令作用
/model <name>切换模型
/m <name>/model 的别名
/effort修改当前模型推理强度
/personas管理 Persona
/config-agents管理 Agent 定义
/agents/config-agents 的别名

5. 权限和工作模式

命令作用
/auto切换自动分类权限模式
/always-approve切换全部自动批准模式
/plan [description]进入计划模式
/view-plan查看当前计划
/goal <objective>启动目标驱动模式
/code-review运行内置代码审查工作流

说明:

  • 再次运行 /auto 可以关闭 Auto 模式。
  • 再次运行 /always-approve 可以关闭 Always Approve。
  • /goal 可能受账号或 Feature Flag 控制。
  • /code-review 从 v0.2.51 开始作为随 CLI 一起提供的内置命令。([SpaceXAI][1])

6. 旁路提问

text
/btw <question>

示例:

text
/btw Why did you choose Redis instead of PostgreSQL?

它用于询问旁支问题,尽量不打断当前主任务。

7. 后台任务和队列

命令作用
/tasks查看后台命令、子 Agent、Monitor 和定时任务
/queue查看等待执行的 Prompt
/loop [interval] <prompt>周期执行 Prompt
/dashboard打开 Agent Dashboard

示例:

text
/loop 5m Check whether the test suite passes and report failures
/loop 1h Check deployment health
/loop 1d Review new dependency updates

时间格式支持:

text
Ns
Nm
Nh
Nd

其中秒级最低为 60 秒。循环任务最多运行七天,同时最多可以存在 50 个 Scheduled Tasks。([SpaceXAI Docs][11])

8. 图片和视频生成

text
/imagine <prompt>
/imagine-video <prompt>

示例:

text
/imagine A clean isometric diagram of this system architecture
/imagine-video Animate this product mockup into a short presentation

这些命令取决于账号、模型和媒体生成功能是否可用。([SpaceXAI Docs][10])

9. UI 与显示命令

命令作用
/settings打开设置
/config/settings 的别名
/theme [name]切换主题
/t [name]/theme 的别名
/compact-mode切换紧凑布局
/multiline切换多行输入
/ml/multiline 的别名
/vim-mode切换 Vim 风格滚动操作
/timestamps显示或隐藏消息时间
/minimal将当前会话切换到 Minimal 模式
/fullscreen将当前会话切换到 Fullscreen 模式

内置主题名称包括:

text
groknight
dark
grokday
light
day
tokyonight
tokyo
rosepine
rose-pine-moon
oscura
oscura-midnight
auto
system

([SpaceXAI Docs][10])

10. 终端诊断

text
/terminal-setup
/terminal-check
/terminal-info

三个命令作用相同,用于检查:

  • 终端类型
  • True Color 支持
  • Clipboard 通路
  • OSC 52
  • tmux / SSH 状态
  • Fullscreen 支持
  • 可能的终端兼容问题

([SpaceXAI Docs][9])

11. 插件、Skills、Hooks 与 MCP

命令作用
/hooks打开 Extensions 的 Hooks 标签
/hooks-trust信任当前项目中的 Hooks
/plugins打开 Plugins 标签
/marketplace打开 Marketplace 标签
/skills打开 Skills 标签
/mcps打开 MCP 标签

这些命令实际上打开的是同一个 Extensions 面板,只是默认选中的标签不同。

/mcps 面板中:

按键作用
Space启用或禁用 MCP
r重新加载配置
i进行 OAuth 登录
a添加 MCP
x移除 MCP

项目级 .grok/hooks/ 需要先通过 /hooks-trust。([SpaceXAI Docs][12])

12. 记忆命令

命令作用
/remember <note>保存一条记忆
/memory浏览和管理记忆
/mem/memory 的别名
/flush立即把会话记忆写入磁盘
/dream运行记忆整合

其中 /memory/mem/flush/dream 只有在跨会话记忆功能启用时才会出现。

CLI 清除记忆:

bash
grok memory clear --workspace
grok memory clear --global
grok memory clear --all

(SpaceXAI Docs)

13. 账号、费用和隐私

命令作用
/login在 TUI 内重新登录
/logout在 TUI 内退出
/usage查看额度、Credits 或账单
/cost/usage 的别名
/privacy查看或切换当前会话的数据保留状态

/usage/cost 是否出现取决于账号类型;免费账号、部分 X 套餐或 API Key 会话可能隐藏该命令。(SpaceXAI Docs)

14. 导入、反馈和版本信息

命令作用
/import-claude打开 Claude 设置导入界面
/feedback [text]发送反馈
/release-notes查看当前版本更新日志
/changelog/release-notes 的别名
13

Skill 动态命令

可由用户调用的 Skill 会成为 Slash Command;名称冲突可使用 namespace,来源包括项目、用户、插件、Agents 与 Claude 兼容目录。

任何设置为“用户可调用”的 Skill 都会自动变成 Slash Command:

text
/<skill-name>

例如:

text
/commit
/deploy
/review-pr
/generate-tests

如果不同来源存在同名 Skill,可以使用带命名空间的形式:

text
/local:commit
/plugin-name:deploy

Skills 可以来自:

text
./.grok/skills/
~/.grok/skills/
插件的 skills/ 目录
~/.agents/skills/
~/.agents/commands/
Claude Code 插件和 Skills

因此你本地看到的 Slash Commands 通常会比本文列出的固定命令更多。(SpaceXAI Docs)

14

TUI 中直接运行 Shell 命令

在 Prompt 开头加 ! 可直接执行 Shell;长时间进程可转到后台并通过 /tasks 查看。

在 Prompt 开头输入 !

text
!git status
!pnpm test
!npm run build
!docker compose ps

这是用户直接执行 Shell 命令,不经过普通自然语言任务解析。

长时间运行的命令可能自动转为后台任务,可以通过:

text
/tasks

查看。! Shell Mode 在官方更新日志中也被用于用户触发的后台命令。(SpaceXAI)

15

文件引用语法

使用 @path 将文件或目录附加到 Prompt,以便解释、审计或重构。

在 Prompt 中使用 @ 引用文件:

text
@src/main.ts Explain this file
@package.json Check for outdated dependencies
@src/auth/ Refactor this module

这不是独立 Slash Command,但属于 Grok Build 最常用的输入语法。(SpaceXAI Docs)

16

历史命令与不稳定命令

除非本地 /help 仍有列出,否则应将 /execute-plan、grok agent --leader 视为已移除或不稳定命令。

更新日志中曾出现过一些命令或内部参数,但当前官方 Reference 已不再正式列出,例如:

text
/execute-plan
grok agent --leader

/execute-plan 至少在 2026 年 5 月的版本中存在,但当前 Modes and Commands 页面不再列出它;它可能已经被 Plan Mode、/view-plan 和普通执行流程替代,或者仅在部分环境中保留。不要把这类命令用于稳定脚本,除非本地 /help 确认仍然存在。(SpaceXAI)

17

最实用的命令组合

提供只读陌生仓库分析、自动修复、CI Code Review、Worktree 并行开发、Schema JSON 与仅允许 Git 的可执行组合。

安全地分析陌生仓库

bash
grok \
  --sandbox read-only \
  --permission-mode dontAsk \
  -p "Analyze the architecture and identify security risks"

自动修改并运行测试

bash
grok \
  --sandbox workspace \
  --always-approve \
  -p "Fix the failing tests, run the test suite, and summarize the changes"

CI 代码审查

bash
grok \
  --no-auto-update \
  --sandbox read-only \
  --permission-mode dontAsk \
  --allow 'Read' \
  --allow 'Grep' \
  --allow 'Bash(git *)' \
  --output-format json \
  -p "Review the current diff and return actionable findings"

并行开发新功能

bash
grok \
  --worktree=feature-auth \
  --ref main \
  "Implement OAuth login and add tests"

结构化输出

bash
grok \
  -p "Audit this repository" \
  --output-format json \
  --json-schema '{
    "type": "object",
    "properties": {
      "summary": {"type": "string"},
      "risks": {
        "type": "array",
        "items": {"type": "string"}
      }
    },
    "required": ["summary", "risks"]
  }'

只允许 Git 和 GitHub CLI

bash
grok \
  --permission-mode dontAsk \
  --allow 'Read' \
  --allow 'Grep' \
  --allow 'Bash(git *)' \
  --allow 'Bash(gh *)' \
  --deny 'Bash(*)' \
  -p "Review the open pull request"

结论

Grok Build 当前的命令体系可以归纳为:

  1. 20 个左右的顶层 CLI 子命令
  2. 40 多个官方固定 Slash Commands
  3. 十多个近期 Changelog 新增或补充命令
  4. 插件和 Skill 动态生成的无限扩展命令
  5. Headless、权限、Sandbox、Worktree 和结构化输出参数

最可靠的本地检查方式仍然是:

bash
grok version
grok --help
grok mcp --help
grok plugin --help
grok sessions --help
grok worktree --help

以及进入 TUI 后运行:

text
/help
/docs

Grok Build 更新频率很高,可以设置每周检查新命令、参数变更和废弃命令的提醒。