
Grok Build
github.com/xai-org/grok-build- Category
- AI Agents
- Rank
- No. 717Tools index
- Listed in
- #18 Code with an agent
- Pricing
- Open Source
- Type
- AGENT
- Use case
- Coding
- Interfaces
- CLI · Editor Extension
- Builder
- xai-org
- GitHub
- 27.2k stars
- Date
About
Grok Build is xAI's terminal-based AI coding agent, running as a full-screen TUI that understands a codebase, edits files, executes shell commands, searches the web, and manages long-running tasks. It supports interactive, headless (CI/scripting), and editor-embedded use via the Agent Client Protocol, with support for MCP servers, skills, plugins, hooks, and sandboxing.
What it does
A terminal-based coding assistant, built as a sprawling Rust workspace of roughly ninety internal crates rather than a single script. You can run it live in a console, drive it unattended from an automated script, or wire it into a code editor through a client-side protocol adapter. On first run it opens a browser to log in. Internally it separates rendering, tool execution, process confinement, and configuration into distinct modules.
Why it's ranked here
The engineering is more serious than a typical agent CLI: kernel-level sandboxing applied at startup, a six-layer configuration system that supports centrally managed enterprise policy down to macOS MDM, and a shared circuit-breaker library reused across server and client retry paths. That depth cuts against openness, though. The repository takes no external pull requests, the root manifest is machine-generated from a private monorepo, and Windows builds are explicitly untested from this tree. Read it to see production-grade agent infrastructure, not to contribute to it.
What's good
The sandbox is genuinely restrictive by default: it blocks subprocess network access via seccomp even though the agent process itself needs the network to reach the model, and the code deliberately fails closed rather than trusting an unconfirmed sandbox as active. Tool output sent back to the model is hard-capped, so a runaway command output cannot blow up context. Configuration merges six layers, letting an IT department push signed, tamper-resistant policy on top of a user's own settings. Retry and circuit-breaking logic is shared, not duplicated, between the client and any server components.
Tradeoffs
Development happens entirely inside a private monorepo and gets synced out; this repository states plainly that it takes no outside patches, so treat it as read-only unless you're willing to fork and diverge. Building from source needs an extra tool-fetching utility on top of the Rust toolchain, and Windows builds are called best-effort and untested here, so Linux or macOS is the safer bet. One internal crate exists purely to keep two incompatible versions of an HTTP client library from colliding, a sign of real dependency-management overhead as the project has grown.
How to use it well
Reach for this if you want an agent CLI with strong isolation defaults for running shell commands and edits against real codebases, and if you already work inside an organization that wants central policy control, including on managed Mac fleets. Install the prebuilt binary rather than building from source unless you specifically need to inspect or patch the code, since patches cannot go upstream anyway. Use the headless mode for CI and scripted pipelines, and remember the sandbox restricts what child processes can reach on the network, not the agent's own model calls.
Technical notes+
The sandbox lives in crates/codegen/xai-grok-sandbox/src/lib.rs: it wraps a Rust sandboxing crate for Landlock and Seatbelt confinement, applies once via a global lock at startup in a way the comments call irreversible, and keys its seccomp child-network filter off the configured profile rather than confirmed enforcement, explicitly to fail closed. Output limits are set in crates/codegen/xai-grok-tools/src/lib.rs: a 40,000-byte cap on tool output sent to the model and a 20,000-character cap on shell output, plus a separate cap for MCP results. crates/codegen/xai-grok-config/src/lib.rs documents a six-layer configuration merge order that ends in macOS MDM managed preferences, with one layer described as signed at rest. crates/codegen/xai-grok-mcp/src/lib.rs isolates a newer HTTP client dependency pulled in by its MCP library behind a private module so it cannot collide with the older HTTP client version used across the rest of the workspace. Cargo.toml lists close to ninety workspace members and is marked auto-generated; CONTRIBUTING.md and LICENSE confirm Apache-2.0 licensing with no external contributions accepted.
Observed
- License
- Apache License 2.0 for first-party code; vendored third-party components (a Mermaid diagram stack) keep their original licenses
- Language
- Rust, organized as a multi-crate workspace
- Distribution
- Prebuilt binaries for macOS, Linux, and Windows via a shell or PowerShell installer, plus build-from-source with Cargo
- Interfaces
- Interactive terminal UI, a headless mode for CI and scripting, and editor integration via the Agent Client Protocol
- Protocol support
- Model Context Protocol (MCP) client, plus support for skills, plugins, and hooks
- Contribution model
- Repository does not accept external pull requests or patches; published for source transparency and local builds only
- Security reporting
- Vulnerabilities are reported through a HackerOne program, not public GitHub issues
- Sandboxing
- OS-level sandbox (Landlock on Linux, Seatbelt on macOS) applied once at process startup
- Build requirement
- Building from source requires a separate hermetic tool-fetching utility in addition to the Rust toolchain and protoc
Read from README.md, Cargo.toml, crates/codegen/xai-grok-agent/src/lib.rs, crates/codegen/xai-grok-sandbox/src/lib.rs, crates/codegen/xai-grok-tools/src/lib.rs, crates/codegen/xai-grok-mcp/src/lib.rs, crates/codegen/xai-grok-config/src/lib.rs, crates/codegen/xai-grok-auth/src/lib.rs, crates/codegen/xai-grok-shell/src/lib.rs, crates/common/xai-tool-runtime/src/lib.rs, crates/common/xai-circuit-breaker/src/lib.rs, SOURCE_REV, SECURITY.md, CONTRIBUTING.md, LICENSE.
What it can do
Analyze and understand a codebase
Codebase → Contextual understanding
Edit files
File content → Modified files
Execute shell commands
Shell command → Command output
Search the web
Search query → Web results
Intel on Grok Build
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.