Grok Build open sourced under Apache 2.0 license

Reddit r/LocalLLaMA Tools

Summary

Grok Build, a terminal-based AI coding agent from xAI, has been open sourced under the Apache 2.0 license. It runs as a full-screen TUI that understands codebases, edits files, executes shell commands, and more.

No content available
Original Article
View Cached Full Text

Cached at: 07/15/26, 09:58 PM

xai-org/grok-build

Source: https://github.com/xai-org/grok-build

SpaceXAI logo
Grok Build (grok)

Grok Build is SpaceXAI’s terminal-based AI coding agent. It runs as a full-screen TUI that understands your codebase, edits files, executes shell commands, searches the web, and manages long-running tasks — interactively, headlessly for scripting/CI, or embedded in editors via the Agent Client Protocol (ACP).

Installing the released binary · Building from source · Documentation · Repository layout · Development · Contributing · License

Grok Build TUI

Learn more about Grok Build at x.ai/cli

This repository contains the Rust source for the grok CLI/TUI and its agent runtime. It is synced periodically from the SpaceXAI monorepo.


Installing the released binary

Prebuilt binaries are published for macOS, Linux, and Windows:

curl -fsSL https://x.ai/cli/install.sh | bash   # macOS / Linux / Git Bash
irm https://x.ai/cli/install.ps1 | iex          # Windows PowerShell
grok --version

See the changelog for the latest fixes, features, and improvements in each release.

Building from source

Requirements:

  • Rust — the toolchain is pinned by rust-toolchain.toml; rustup installs it automatically on first build.
  • protoc — proto codegen resolves bin/protoc (a dotslash launcher) or falls back to a protoc on PATH / $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 authentication guide.

Documentation

Full online documentation is available at docs.x.ai/build/overview.

The user guide ships with the pager crate: crates/codegen/xai-grok-pager/docs/user-guide/ — getting started, keyboard shortcuts, slash commands, configuration, theming, MCP servers, skills, plugins, hooks, headless mode, sandboxing, and more.

Repository layout

PathContents
crates/codegen/xai-grok-pager-binComposition-root package; builds the xai-grok-pager binary
crates/codegen/xai-grok-pagerThe TUI: scrollback, prompt, modals, rendering
crates/codegen/xai-grok-shellAgent runtime + leader/stdio/headless entry points
crates/codegen/xai-grok-toolsTool implementations (terminal, file edit, search, …)
crates/codegen/xai-grok-workspaceHost 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

The root Cargo.toml (workspace members, dependency versions, lints, profiles) is generated — treat it as read-only. Prefer editing per-crate Cargo.toml files.

Development

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

Contributing

External contributions are not accepted. See CONTRIBUTING.md.

License

First-party code in this repository is licensed under the Apache License, Version 2.0 — see LICENSE.

Third-party and vendored code remains under its original licenses. See:

Similar Articles

xai-org/grok-build, now open source

Simon Willison's Blog

xAI faced backlash after its Grok CLI tool was found to upload entire directories to its servers. In response, xAI deleted retained data, disabled default data retention, and open-sourced the entire Grok Build codebase under Apache 2.0 to regain user trust.

Grok Build 0.1 on API (1 minute read)

TLDR AI

xAI has released grok-build-0.1 in public beta via API, a model optimized for agentic coding tasks with high speed and competitive pricing.