xAI Grok CLI (Grok Build)
xAI · cli agent · paid
xAI’s coding agent CLI/TUI (Grok Build) for complex engineering work — fullscreen terminal UI, Plan Mode, subagents, powered by Grok models. Install: curl -fsSL https://x.ai/cli/install.sh | bash. Open source: xai-org/grok-build. Official changelog at x.ai/build/changelog (may bot-block scrapers).
Helps prioritize which assistants and sources we maintain. Anonymous · one vote per visitor.
Config files xAI Grok CLI (Grok Build) has changed
Config you own — hooks, permission rules, MCP servers, settings — that releases below state a change to. Counted from the release notes we track, newest change first. How a harness is layered.
Release signals
Run headlessly
Primary source ↗Start an interactive session
Primary source ↗Grok Build
Primary source ↗Headless & Scripting
Primary source ↗Skills, Plugins & Marketplaces
Primary source ↗Model Retirement on May 15 New
Primary source ↗Enterprise Deployments
Primary source ↗Keyboard Shortcuts
Primary source ↗Modes and Commands
Primary source ↗License
First-party code in this repository is licensed under the Apache License, · Version 2.0 — seeLICENSE. · Third-party and vendored code remains under its original licenses. · See: · THIRD-PARTY-NOTICES — crates.io / git dependencies, · bundled UI themes, and in-tree source ports (including openai/codex and · sst/opencode tool implementations) · crates/codegen/xai-grok-tools/THIRD_PARTY_NOTICES.md · — crate-local notice for the codex and opencode ports (license texts + · +2 more changesPrimary source ↗Contributing
[!NOTE] · > External contributions are not accepted. · SeeCONTRIBUTING.md.
Primary source ↗Development
sh · cargo check -p <crate> # always target specific crates; full-workspace builds are slow · cargo test -p xai-grok-config # per-crate tests · cargo clippy -p <crate> # lint config: clippy.toml at the repo root · cargo fmt --all # rustfmt.toml at the repo root · Primary source ↗Repository layout
| Path | Contents | · |------|----------| · |crates/codegen/xai-grok-pager-bin | Composition-root package; builds the xai-grok-pager binary | · | crates/codegen/xai-grok-pager | The TUI: scrollback, prompt, modals, rendering | · | crates/codegen/xai-grok-shell | Agent runtime + leader/stdio/headless entry points | · | crates/codegen/xai-grok-tools | Tool implementations (terminal, file edit, search, ...) | · | crates/codegen/xai-grok-workspace | Host filesystem, VCS, execution, checkpoints | · +8 more changesRead the full release noteHide the full release note
| Path | Contents |
|---|---|
crates/codegen/xai-grok-pager-bin | Composition-root package; builds the xai-grok-pager binary |
crates/codegen/xai-grok-pager | The TUI: scrollback, prompt, modals, rendering |
crates/codegen/xai-grok-shell | Agent runtime + leader/stdio/headless entry points |
crates/codegen/xai-grok-tools | Tool implementations (terminal, file edit, search, ...) |
crates/codegen/xai-grok-workspace | Host filesystem, VCS, execution, checkpoints |
crates/codegen/... | The rest of the CLI crate closure (config, MCP, markdown, sandbox, ...) |
crates/common/, crates/build/, prod/mc/ | Small shared leaf crates pulled in by the closure |
third_party/ | Vendored upstream source (Mermaid diagram stack) — see below |
[!IMPORTANT] The root
Cargo.toml(workspace members, dependency versions, lints, profiles) is generated — treat it as read-only. Prefer editing per-crateCargo.tomlfiles.
ing from source
Requirements: · Rust — the toolchain is pinned byrust-toolchain.toml; · rustup installs it automatically on first build. · DotSlash — required so hermetic tools under · bin/ (notably bin/protoc) can download and run. · Install it and ensure dotslash is on your PATH before building: · sh · cargo install dotslash · /usr/bin/env dotslash --help # sanity check · · protoc — proto codegen resolves bin/protoc via DotSlash, · +13 more changesRead the full release noteHide the full release note
Requirements:
-
Rust — the toolchain is pinned by
rust-toolchain.toml;rustupinstalls it automatically on first build. -
DotSlash — required so hermetic tools under
bin/(notablybin/protoc) can download and run. Install it and ensuredotslashis on yourPATHbefore building:cargo install dotslash # or: prebuilt packages — https://dotslash-cli.com/docs/installation/ /usr/bin/env dotslash --help # sanity check -
protoc — proto codegen resolves
bin/protocvia DotSlash, or falls back to aprotoconPATH/$PROTOC. -
macOS and Linux are supported build hosts; Windows builds are best-effort and not currently tested from this tree.
cargo run -p xai-grok-pager-bin # build + launch the TUI
cargo build -p xai-grok-pager-bin --release # release binary: target/release/xai-grok-pager
cargo check -p xai-grok-pager-bin # fast validation
The binary artifact is named xai-grok-pager; official installs ship it as
grok. On first launch it opens your browser to authenticate — see the
Excerpt ends here — this release continues at the source ↗.
Polled sources
[official-changelog] Grok Build Changelog (official — may 403 bots)
html · every 360m
https://x.ai/build/changelog[github-readme] grok-build README
markdown_changelog · every 360m
https://raw.githubusercontent.com/xai-org/grok-build/main/README.md[github-commits] xai-org/grok-build commits
github_commits · every 60m
https://github.com/xai-org/grok-build