截至 2026 年 7 月 16 日,Grok Build 官方最新版本是 v0.2.101,发布于 7 月 13 日。需要注意的是,官方 CLI Reference 只列出“最常用”的参数;插件、Skills、实验功能和账号权限还会动态增加命令,因此不存在一张永久不变的绝对完整表。下面汇总的是:官方文档中的固定命令 + 近期 Changelog 新增命令 + 条件启用命令。([SpaceXAI][1])
先用这几个命令检查你本地安装版本的真实命令集:
grok version
grok --help
grok <subcommand> --help进入 Grok Build 后:
/help也可以直接输入 / 打开当前版本的命令菜单。
安装、启动与登录
涵盖 macOS、Linux、WSL、Windows 安装,在项目或指定目录启动,以及 OAuth、设备验证与 XAI_API_KEY 认证。
1. 安装
macOS、Linux、WSL:
curl -fsSL https://x.ai/cli/install.sh | bashWindows PowerShell:
irm https://x.ai/cli/install.ps1 | iex2. 启动
cd your-project
grok指定工作目录启动:
grok --cwd /path/to/project使用 API Key:
export XAI_API_KEY="xai-..."
grok3. 登录和退出
grok login
grok login --device-auth
grok logout--device-auth 适合 SSH、服务器、容器、WSL 等不方便打开浏览器的环境。(SpaceXAI Docs)
全部顶层 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 | 获取并安装托管配置 |
诊断、模型与配置命令
检查实际生效的规则与扩展、列出和选择可用模型、调整 effort、查看版本、生成 Shell 补全并安装组织托管配置。
grok inspect
查看 Grok 在当前目录实际发现了哪些配置:
grok inspect
grok inspect --json输出通常包括:
- 配置文件来源
AGENTS.md、CLAUDE.md- Skills
- 插件
- Hooks
- MCP Servers
- Claude、Cursor、Codex 兼容配置
- 当前认证和模型配置
这是排查“为什么某个 Skill、MCP 或规则没有生效”时最重要的命令。
grok models
grok models查看当前账号、API Key 或自定义模型端点能够访问的模型。
启动时指定模型:
grok -m <model-id>
grok --model <model-id>交互界面切换模型:
/model <model-id>
/m <model-id>grok version
grok versiongrok completions
grok completions bash
grok completions zsh
grok completions fishgrok setup
grok setup主要用于获取和安装组织托管的 Grok Build 配置。(SpaceXAI Docs)
Headless 与脚本命令
以 plain、JSON、streaming JSON 或 JSON Schema 执行单次任务,在 CI 关闭更新检查,并通过 ACP stdio 集成。
1. 单次执行
grok -p "Explain this repository"完整形式:
grok --single "Explain this repository"-p 或 --single 让 Grok 执行一次任务后退出,适合脚本、CI、机器人和自动化。([SpaceXAI Docs][4])
2. 输出格式
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 输出
grok -p "Analyze this project" \
--json-schema '{"type":"object","properties":{"language":{"type":"string"}},"required":["language"]}'--json-schema 会要求 Headless 模式返回符合指定 Schema 的 JSON,而不是自由文本。([SpaceXAI][1])
4. CI 中关闭更新检查
grok --no-auto-update -p "Run the test suite"CI 常用组合:
grok \
--no-auto-update \
--always-approve \
--output-format json \
-p "Review this pull request"5. ACP Agent 模式
grok agent stdio该模式通过 stdin/stdout 使用 JSON-RPC,适合 IDE、编辑器或其他 Agent 客户端集成。(SpaceXAI Docs)
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 等级可能不同,使用:
grok models或者在界面里运行:
/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-permissions | Claude Code 兼容别名 |
--permission-mode 支持的 Headless 模式包括:
| 值 | 行为 |
|---|---|
default | 使用默认权限行为 |
dontAsk | 没有明确允许规则的操作直接拒绝 |
acceptEdits | 自动批准文件编辑,Shell 命令仍询问 |
bypassPermissions | 跳过权限检查 |
plan | 计划模式 |
示例:
grok -p "Review the API changes" \
--permission-mode dontAsk \
--allow 'Bash(git *)' \
--allow 'Bash(gh *)' \
--allow 'Read' \
--allow 'Grep' \
--deny 'Bash(rm -rf *)'支持的权限过滤器包括:
Bash
Edit
Read
Grep
MCPTool
WebFetch例如:
--allow 'Bash(git *)'
--allow 'Edit(**/*.ts)'
--allow 'MCPTool(linear__*)'
--deny 'Edit(**/.env)'拒绝规则优先级高于允许规则。([SpaceXAI Docs][5])
4. Sandbox 参数
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> | 移除指定工具 |
--allowedTools | Claude Code 兼容别名 |
--disallowedTools | Claude Code 兼容别名 |
--append-system-prompt | Claude Code 兼容别名 |
--system-prompt | Claude Code 兼容别名 |
示例:
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)
会话管理命令
恢复或继续会话、列出/搜索/删除历史、导出到文件或剪贴板、导入 Claude Code 会话,以及在脚本中获取 session ID。
CLI 命令
grok --resume <session-id>
grok --resume
grok -c会话管理:
grok sessions list
grok sessions search "authentication"
grok sessions delete <session-id>导出:
grok export <session-id>
grok export <session-id> output.md
grok export <session-id> --clipboard导入 Claude Code 会话:
grok import
grok import <target>
grok import <target1> <target2>Headless 获取新会话 ID:
SESSION_ID=$(
grok -p "Start the refactor" \
--output-format json |
jq -r '.sessionId'
)
grok -r "$SESSION_ID" -p "Continue and run tests"Git Worktree 命令
启动隔离的 Worktree 会话、区分命名语法、查看或移除托管 Worktree、预览删除并清理缺失或过期记录。
启动 Worktree 会话
grok -w
grok --worktree
grok --worktree=feat "Refactor module X"
grok -w --ref main "Fix the flaky test"
grok -w -r <session-id>注意下面两种写法的差异:
grok --worktree=feat "Refactor module X"feat 是 Worktree 名称。
grok --worktree feat某些解析场景下,feat 可能被视作 Prompt,因此建议显式使用等号。
管理 Worktree
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 |
MCP 命令
列出 MCP Server,添加 stdio 或 HTTP transport,设置可重复 Header 与环境变量,选择项目范围、移除 Server 并运行 doctor 诊断。
1. 查看 MCP Server
grok mcp list
grok mcp list --json2. 添加本地 stdio MCP
grok mcp add filesystem -- \
npx -y @modelcontextprotocol/server-filesystem /path/to/dir-- 后面的内容是启动 MCP Server 的真实命令。
3. 添加远程 HTTP MCP
grok mcp add \
--transport http \
linear \
https://mcp.linear.app/mcp4. 添加带 Header 的 MCP
grok mcp add \
--transport http \
api \
https://mcp.example.com/mcp \
--header "Authorization: Bearer ${API_TOKEN}"Header 可以重复指定:
grok mcp add \
--transport http \
example \
https://example.com/mcp \
-H "Authorization: Bearer ${TOKEN}" \
-H "X-Team-ID: ${TEAM_ID}"5. 项目级 MCP
grok mcp add \
--scope project \
filesystem -- \
npx -y @modelcontextprotocol/server-filesystem .这会写入项目的:
.grok/config.toml而不是用户全局配置。
6. 删除与诊断
grok mcp remove <name>
grok mcp doctor
grok mcp doctor <name>
grok mcp doctor --json
grok mcp doctor <name> --json相关参数还包括:
-e
-H
--header
--transport
--scope project其中 -e 用于传递环境变量,-H 是 Header 的短参数。(SpaceXAI Docs)
插件与 Marketplace 命令
列出、安装、卸载、更新、启用、禁用、查看和验证插件,并管理远程或本地 Marketplace 来源。
插件命令
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 命令
grok plugin marketplace list
grok plugin marketplace add ...
grok plugin marketplace remove ...
grok plugin marketplace update ...Marketplace Source 可以是配置的远程源,也可以是本地目录。由于不同来源接受的参数形式可能不同,应通过以下命令确认:
grok plugin install --help
grok plugin marketplace add --help插件可以提供额外的 Skills、Agents、Hooks、MCP Servers、LSP Servers 和 Slash Commands。(SpaceXAI Docs)
更新命令
检查更新、安装指定版本,或在 Alpha 与 Stable 渠道之间切换。
grok update
grok update --check
grok update --version <VERSION>
grok update --alpha
grok update --stable示例:
grok update --check
grok update --version 0.2.101
grok update --alpha
grok update --stable| 参数 | 作用 |
|---|---|
| 无参数 | 更新到当前渠道的最新版本 |
--check | 只检查,不安装 |
--version <V> | 安装指定版本 |
--alpha | 切换或安装 Alpha 渠道 |
--stable | 切换或安装 Stable 渠道 |
终端代理命令 grok wrap
包装 SSH、Docker、kubectl 命令,将远程 OSC 52 剪贴板内容转发到本机;该功能目前仍为实验性质。
grok wrap <command...>常见用法:
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)
全部固定 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-worktree | Fork 但不创建 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 |
示例:
/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. 旁路提问
/btw <question>示例:
/btw Why did you choose Redis instead of PostgreSQL?它用于询问旁支问题,尽量不打断当前主任务。
7. 后台任务和队列
| 命令 | 作用 |
|---|---|
/tasks | 查看后台命令、子 Agent、Monitor 和定时任务 |
/queue | 查看等待执行的 Prompt |
/loop [interval] <prompt> | 周期执行 Prompt |
/dashboard | 打开 Agent Dashboard |
示例:
/loop 5m Check whether the test suite passes and report failures
/loop 1h Check deployment health
/loop 1d Review new dependency updates时间格式支持:
Ns
Nm
Nh
Nd其中秒级最低为 60 秒。循环任务最多运行七天,同时最多可以存在 50 个 Scheduled Tasks。([SpaceXAI Docs][11])
8. 图片和视频生成
/imagine <prompt>
/imagine-video <prompt>示例:
/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 模式 |
内置主题名称包括:
groknight
dark
grokday
light
day
tokyonight
tokyo
rosepine
rose-pine-moon
oscura
oscura-midnight
auto
system([SpaceXAI Docs][10])
10. 终端诊断
/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 清除记忆:
grok memory clear --workspace
grok memory clear --global
grok memory clear --all13. 账号、费用和隐私
| 命令 | 作用 |
|---|---|
/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 的别名 |
Skill 动态命令
可由用户调用的 Skill 会成为 Slash Command;名称冲突可使用 namespace,来源包括项目、用户、插件、Agents 与 Claude 兼容目录。
任何设置为“用户可调用”的 Skill 都会自动变成 Slash Command:
/<skill-name>例如:
/commit
/deploy
/review-pr
/generate-tests如果不同来源存在同名 Skill,可以使用带命名空间的形式:
/local:commit
/plugin-name:deploySkills 可以来自:
./.grok/skills/
~/.grok/skills/
插件的 skills/ 目录
~/.agents/skills/
~/.agents/commands/
Claude Code 插件和 Skills因此你本地看到的 Slash Commands 通常会比本文列出的固定命令更多。(SpaceXAI Docs)
TUI 中直接运行 Shell 命令
在 Prompt 开头加 ! 可直接执行 Shell;长时间进程可转到后台并通过 /tasks 查看。
在 Prompt 开头输入 !:
!git status
!pnpm test
!npm run build
!docker compose ps这是用户直接执行 Shell 命令,不经过普通自然语言任务解析。
长时间运行的命令可能自动转为后台任务,可以通过:
/tasks查看。! Shell Mode 在官方更新日志中也被用于用户触发的后台命令。(SpaceXAI)
文件引用语法
使用 @path 将文件或目录附加到 Prompt,以便解释、审计或重构。
在 Prompt 中使用 @ 引用文件:
@src/main.ts Explain this file
@package.json Check for outdated dependencies
@src/auth/ Refactor this module这不是独立 Slash Command,但属于 Grok Build 最常用的输入语法。(SpaceXAI Docs)
历史命令与不稳定命令
除非本地 /help 仍有列出,否则应将 /execute-plan、grok agent --leader 视为已移除或不稳定命令。
更新日志中曾出现过一些命令或内部参数,但当前官方 Reference 已不再正式列出,例如:
/execute-plan
grok agent --leader/execute-plan 至少在 2026 年 5 月的版本中存在,但当前 Modes and Commands 页面不再列出它;它可能已经被 Plan Mode、/view-plan 和普通执行流程替代,或者仅在部分环境中保留。不要把这类命令用于稳定脚本,除非本地 /help 确认仍然存在。(SpaceXAI)
最实用的命令组合
提供只读陌生仓库分析、自动修复、CI Code Review、Worktree 并行开发、Schema JSON 与仅允许 Git 的可执行组合。
安全地分析陌生仓库
grok \
--sandbox read-only \
--permission-mode dontAsk \
-p "Analyze the architecture and identify security risks"自动修改并运行测试
grok \
--sandbox workspace \
--always-approve \
-p "Fix the failing tests, run the test suite, and summarize the changes"CI 代码审查
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"并行开发新功能
grok \
--worktree=feature-auth \
--ref main \
"Implement OAuth login and add tests"结构化输出
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
grok \
--permission-mode dontAsk \
--allow 'Read' \
--allow 'Grep' \
--allow 'Bash(git *)' \
--allow 'Bash(gh *)' \
--deny 'Bash(*)' \
-p "Review the open pull request"结论
Grok Build 当前的命令体系可以归纳为:
- 20 个左右的顶层 CLI 子命令;
- 40 多个官方固定 Slash Commands;
- 十多个近期 Changelog 新增或补充命令;
- 插件和 Skill 动态生成的无限扩展命令;
- Headless、权限、Sandbox、Worktree 和结构化输出参数。
最可靠的本地检查方式仍然是:
grok version
grok --help
grok mcp --help
grok plugin --help
grok sessions --help
grok worktree --help以及进入 TUI 后运行:
/help
/docsGrok Build 更新频率很高,可以设置每周检查新命令、参数变更和废弃命令的提醒。