Watch

REPO-015 · xAI Grok Build upstream source mirror · learning and purification only · not trusted runtime

Rust 99.6%
Python 0.2%
JavaScript 0.1%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
grokkybara[bot] 7cfcb20d2b Synced from monorepo Changes: - Gate session-lifecycle heap steady state with a dhat soak - Unbreak merge lifecycle e2e after default model → grok-4.5 - Scan home-scope rules dirs at <root>/rules - Complete text-input paste and terminal parity - Gate project roles and personas - Use canonical editing in dialogs - Use canonical editing in search bars - Reject ambiguous MCP tool IDs - Harden Git operands for plugins - Simplify queue drain API - Pass RFC 9207 iss through MCP OAuth token exchange - Show leader roster when local agents map is empty - Use canonical editing in Persona views - Remove marketplace default-skills auto-install and purge old installs - Use canonical editing in extension forms - Add canonical dashboard text editing - Use canonical editing in settings - Add /summarize as a /recap alias - Restore previous agent when exiting dashboard - Use tool_choice auto for compaction - Settings toggle for snap-prompt-to-top on send - Update default models to grok-4.5 - Source login shell once for local bash (env + alias/function snapshot) - Template hardcoded param names in server-native tool descriptions - Fix System-Reminder XML tag injection in CLAUDE.md via agents_md - Fix remote workspace-server hardcoding LSP trust (repo code execution risk) - Clear orphaned tool-call updates at turn end - Suppress task wake after cancel - Send x-grok-client-identifier on direct API tool calls - Harden dashboard peek lease transitions - Host /btw side panel in live region (minimal mode) - Bound scroll presentation latency - Highlight multi-line constructs correctly in diffs and the file viewer - Block web_fetch non-public IPs; local opt-in is explicit-host only - Seed coding_data_retention_opt_out=false for OAuth e2es in pty-harness - Follow up clipboard delivery feedback - Use canonical editing in pickers - Route TextArea through canonical editor - Persistent "watching" status row; quieter turn markers - Gate sensitive edit targets - Expose agent registry counts and gate session churn on them - Default coding data sharing to opt-out until server preference applies - Wire chat attachment ids through gateway prompts - On auth refresh failure, issue retry - Forward preview provenance and computer lifecycle state - Document independent privacy controls and scope /privacy output - Strip SamplingError Display prefix on rate-limit UI copy - Stop dumping Cloudflare HTML into Retry failed - Disable in-place prompt edit (scroll jank on enter) - Strip forced ANSI color from gh pr view JSON - Plumb bash tool description onto ToolUsageCard wire		2026-07-18 19:48:28 +01:00
.cargo	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
bin	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
crates	Synced from monorepo	2026-07-18 19:48:28 +01:00
prod/mc/cli-chat-proxy-types	Synced from monorepo	2026-07-17 14:19:50 +01:00
third_party	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
.gitignore	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
Cargo.lock	Synced from monorepo	2026-07-18 19:48:28 +01:00
Cargo.toml	Synced from monorepo	2026-07-18 19:48:28 +01:00
clippy.toml	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
CONTRIBUTING.md	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
LICENSE	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
README.md	Synced from monorepo	2026-07-16 20:27:30 +01:00
rust-toolchain.toml	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
rustfmt.toml	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
SECURITY.md	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00
SOURCE_REV	Synced from monorepo	2026-07-18 19:48:28 +01:00
THIRD-PARTY-NOTICES	Publish harness and TUI open-source	2026-07-16 06:46:02 +01:00

README.md

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

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.

A small SOURCE_REV file at the root records the full monorepo commit SHA for the version of the code present in this tree.

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.
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:
```
cargo install dotslash
# or: prebuilt packages — https://dotslash-cli.com/docs/installation/
/usr/bin/env dotslash --help   # sanity check
```
protoc — proto codegen resolves bin/protoc via DotSlash, 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

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-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

Note

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:

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 + Apache §4(b) change notice)
third_party/NOTICE — vendored Mermaid-stack index