Coding agent (CLI) · xAI (its current pages brand the company SpaceXAI; the docs site also writes SpaceXSI)
Grok Build
xAI's terminal coding agent, run as grok. Full-screen TUI with plan mode, subagents, worktrees, MCP and headless or ACP use. First-party source is public under Apache-2.0; needs sign-in or an API key.
Grok Build review
Grok Build is a terminal coding agent from xAI, started with grok. The pages we read call the company SpaceXAI. The docs say it runs as a full-screen text interface, headless with grok -p, or over the Agent Client Protocol. We read the vendor docs, the repository's README and licence files, and Internet Archive copies of x.ai pages, as x.ai returned 403 to us. The copies date from 25 July 2026 (product), 6 September 2026 (changelog) and 11 November 2026 (pricing). We did not install or run it.
What the docs describe
- Plan mode rejects edits, apart from the plan file, until you approve a plan.
- Subagents, background tasks and an agent dashboard exist.
- Worktree sessions give parallel agents isolated checkouts.
- It loads MCP config from Claude Code and Cursor files, and grok import brings in Claude Code sessions.
Source, install and cost
First-party code is public at xai-org/grok-build under Apache-2.0. GitHub's API showed 27,746 stars on 12 November 2026. The README says it is synced from the vendor's monorepo, and CONTRIBUTING says outside pull requests are not accepted. The README says prebuilt binaries cover macOS, Linux and Windows.
We found no separate price for the CLI. On the archived pricing page, Plus is $8 a month with Build in a shared usage pool, and Premium is $30. The compare table lists Grok Build as "Limited" on Free and "Included" on Plus and above. We found no per-plan usage numbers. The newest archived changelog entry is v1.0.13 (28 August 2026), but the repository manifests say 1.0.45, so that archive may be stale.
Limits worth knowing
The docs say the sandbox is off by default, its child-process network limit is enforced on Linux only, and built-in profiles do not permanently protect paths such as ~/.ssh. They also say plan mode gates edit tools, not the shell, so bash can still write files by redirection.
See also Claude Code, Codex CLI and OpenCode.
Facts: platforms, price and licence
- platforms
- macOSWindowsLinuxDocs give a curl installer (the README labels it macOS / Linux / Git Bash) and a PowerShell installer for Windows; the README says prebuilt binaries are published for macOS, Linux and Windows. The README calls Windows source builds best-effort and not currently tested from the public tree. x.ai returned 403 to our fetches, so x.ai/cli, x.ai/pricing and x.ai/build/changelog were read through Internet Archive copies (captured 2026-07-25, 2026-11-11 and 2026-09-06 respectively).
- price
- FreemiumNo standalone price for the CLI was found. Access runs through sign-in (browser, or XAI_API_KEY where there is no browser). Archived x.ai/pricing (captured 2026-11-11, not the live page) lists Free $0, Plus $8/month, Premium $30/month (4x Plus usage), Super $100/month (15x), Ultra $200/month (50x); Teams from $30/user/month. Its compare table (read from the page HTML) shows Grok Build as 'Limited' on Free and 'Included' on Plus, Premium, Super, Ultra, Teams and Enterprise; the Plus card lists 'Grok Chat, Voice, Imagine, and Build' from a shared usage pool. docs.x.ai/x-subscription/pricing lists the same individual prices (annual: Plus $80, Premium $300, Super $1000, Ultra $2000), shows Free included usage as 'Limited', and says to see x.ai/pricing for current terms. An archived x.ai/cli (captured 2026-07-25) said 'Available to try for Free'. No per-plan Grok Build usage numbers were found. API-key usage billing was not checked. Seen 2026-11-12.
- source
- Open sourceLicence: Apache-2.0 for first-party code (LICENSE file begins 'Copyright 2023-2026 SpaceXAI'; README says third-party and vendored code keeps its own licences, listed in THIRD-PARTY-NOTICES)
- github
- xai-org/grok-build 27.8k stars, seen 2026-11-13
Grok Build features
- ✓ yes MCP
- ✓ yes Multi-agent
- ✓ yes Headless / CI
- ✓ yes Sandbox
- ? not verified Local models
- ✓ yes Your own API key
- ✓ yes Git worktrees
- ? not verified SSH
✓ documented · – absent or not in its feature list · ? not verified
Grok Build strengths
- Public Rust source under Apache-2.0 at xai-org/grok-build, with prebuilt installers for macOS, Linux and Windows
- Plan mode blocks edit tools until you approve a plan; permission modes (ask, auto, always-approve) with allow/deny rules; optional sandbox profiles using Seatbelt on macOS and Landlock on Linux
- Parallel work is documented: subagents, git worktree sessions, background tasks, an agent dashboard, and headless (grok -p) or ACP use for scripts and editors
- Reads MCP config from Claude Code and Cursor files, adds servers with grok mcp, and grok import brings in Claude Code sessions
Grok Build weak points
- The sandbox is off by default; child-network limits are enforced on Linux only (no-op on macOS for read-only and strict), and built-in profiles do not permanently protect paths such as ~/.ssh
- Plan mode gates edit tools, not the shell, so bash can still write files by redirection
- The public repo accepts no external pull requests and is synced periodically from an internal monorepo; Windows source builds are best-effort and untested from that tree
- Needs sign-in or an XAI_API_KEY; the archived pricing page marks Grok Build on the Free plan as 'Limited' and no usage numbers per plan were found
- Terminal quirks are documented: Apple Terminal ignores OSC 52 clipboard writes, and VS Code, Cursor, Windsurf and Zed terminals cannot tell Shift+Enter from Enter
Who Grok Build is for
- best for
- Developers who already use or would use an xAI/Grok account and want a terminal coding agent with plan review, worktrees and headless mode, with source they can read.
- look elsewhere if
- Anyone who wants a general terminal emulator or SSH client, or who needs published per-plan usage numbers before committing (none were found).
Lists that include Grok Build
Sources and what we could not verify
Checked 2026-10-21. Prices and features change; the vendor's page is the authority.
- docs.x.ai/build/overview — what it is, install commands, browser sign-in or XAI_API_KEY, headless grok -p, custom models via config.toml, grok-4.7 on API, SpaceXSI branding
- docs.x.ai/build/overview.md — markdown copy of the overview page
- docs.x.ai/llms.txt — docs index listing Grok Build pages; 'Official SpaceXSI (xAI) developer documentation'
- docs.x.ai/build/features/plan-mode.md — plan mode: edits blocked until approval; bash can still write via redirection
- docs.x.ai/build/features/subagents.md — subagents with built-in types general-purpose, explore, plan
- docs.x.ai/build/features/worktrees.md — git worktree sessions for parallel agents, grok worktree commands
- docs.x.ai/build/features/dashboard.md — agent dashboard for all sessions
- docs.x.ai/build/features/background-tasks.md — background tasks, /loop scheduled prompts, monitors
- docs.x.ai/build/features/mcp-servers.md — MCP servers, grok mcp, loads ~/.claude.json and .cursor/mcp.json
- docs.x.ai/build/features/sandbox.md — sandbox profiles, off by default, Landlock/Seatbelt, limitations (network on Linux only, ~/.ssh)
- docs.x.ai/build/features/permissions.md — ask/auto/always-approve modes, allow/deny rules
- docs.x.ai/build/cli/reference.md — subcommands incl. grok import (from Claude Code), flags --worktree --sandbox
- docs.x.ai/build/cli/headless-scripting.md — headless output formats, ACP via grok agent stdio
- docs.x.ai/build/cli/terminal-support.md — terminal quirks (Apple Terminal OSC 52, VS Code/Cursor/Zed Shift+Enter, tmux/Zellij)
- docs.x.ai/build/enterprise.md — enterprise deployments, SSO, ZDR, BYOK endpoints note
- docs.x.ai/x-subscription/pricing.md — individual and team plan prices, shared usage pool, refers to x.ai/pricing
- docs.x.ai/x-subscription/usage-limits.md — weekly pool shared across Grok and Cursor; first-party usage only; top-ups
- api.github.com/repos/xai-org/grok-build — 27746 stars, Apache-2.0, Rust, created 2026-07-14, pushed 2026-09-29, not archived, no latest release (read 2026-11-12 via authenticated gh api; the unauthenticated call was rate-limited); description 'SpaceXAI's coding agent harness and TUI. Fullscreen, mouse interactive, extensible.'
- github.com/xai-org/grok-build — README: prebuilt binaries for macOS/Linux/Windows, Windows source builds best-effort, synced from monorepo, Apache-2.0, notices list ports of openai/codex and sst/opencode tool code
- raw.githubusercontent.com/xai-org/grok-build/HEAD/CONTRIBUTING.md — no external pull requests accepted
- raw.githubusercontent.com/xai-org/grok-build/HEAD/LICENSE — Apache License 2.0, copyright SpaceXAI
- web.archive.org/web/20260725155729/https://x.ai/cli — archived official product page: 'Available to try for Free', Grok 4.5 at that date, install command, links to docs, changelog, open source
- web.archive.org/web/20261111072206/https://x.ai/pricing — archived official pricing page (captured 2026-11-11): plan prices, Build in Plus shared pool, compare table row Grok Build = Limited (Free) / Included (Plus and above)
- web.archive.org/web/20260906084923/https://x.ai/build/changelog — archived changelog: latest v1.0.13, Aug 28, 2026
- raw.githubusercontent.com/xai-org/grok-build/HEAD/crates/codegen/xai-grok-pager-bin/Cargo.toml — package version 1.0.45 at repo head (read 2026-11-12)
- raw.githubusercontent.com/xai-org/grok-build/HEAD/THIRD-PARTY-NOTICES — in-tree ports of openai/codex tool handlers (and opencode) keep their own licences
Not verified
- Release status: the official pages read (docs, repo README, archived x.ai/cli, archived changelog) do not label Grok Build beta or waitlist and give a public installer, so it is treated as released; this absence of a label was only noticed, not confirmed by a statement. Launch-time press describing an early beta (May 2026) is secondary and was not used for any fact.
- Plan access: read from the archived pricing page (2026-11-11) only; live x.ai pages return 403, so current plan terms are unconfirmed. docs.x.ai pricing does not list Grok Build per plan. Usage numbers per plan for Grok Build were not found (only 4x/15x/50x multiples of Plus for the overall pool).
- Archived x.ai/cli (2026-07-25) and archived changelog (2026-09-06) may be older than the live pages; repo manifests at head say 1.0.45 versus changelog v1.0.13, so newer releases exist or the versioning differs (not confirmed). The GitHub repo has no GitHub Releases entry (releases/latest returned 404).
- Default model today is not confirmed (Grok 4.5 on the July archived page, grok-4.7 named as the latest API model in current docs).
- Vendor naming differs across pages (xAI, SpaceXAI, SpaceXSI); the relationship between the names is not explained on a page read.
- ssh, sftp, tabs, split_panes, port_forwarding, jump_host, x11_forwarding, serial, telnet, mosh, cloud_sync, team_sharing not stated for the CLI; phone_remote and mobile_app left null (Grok iOS/Android apps appear in the site nav, but they are the chat product, not Grok Build); local_models not stated.
- The claims that it appears on benchmark boards or is used as 'Claude Code overflow' were not verified from any official page and are not recorded; only the documented Claude Code import and MCP-config compatibility were confirmed.
- GitHub star count was read from the API on 2026-11-12 and will drift.
- Cost of API-key use (per-token billing) was not checked.
- The product-page claim 'Available to try for Free' (archived 2026-07-25) and the Free-plan 'Limited' Grok Build access could not be checked against live pages.