Headless & Scripting
Headless & Scripting
Primary source ↗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.
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 ↗First-party code in this repository is licensed under the **Apache License, Version 2.0** — see [`LICENSE`](LICENSE). Third-party and vendored code remains under its original licenses. See:
Primary source ↗> [!NOTE] > External contributions are not accepted. See [`CONTRIBUTING.md`](CONTRIBUTING.md).
Primary source ↗```sh cargo check -p <crate> # always target specific crates; full-workspace builds are slow cargo test -p xai-grok-config # per-crate tests
Primary source ↗| Path | Contents | |------|----------| | `crates/codegen/xai-grok-pager-bin` | Composition-root package; builds the `xai-grok-pager` binary |
Primary source ↗Full online documentation is available at [docs.x.ai/build/overview](https://docs.x.ai/build/overview). The user guide ships with the pager crate:
Primary source ↗Requirements: **Rust** — the toolchain is pinned by [`rust-toolchain.toml`](rust-toolchain.toml); `rustup` installs it automatically on first build.
Primary source ↗Prebuilt binaries are published for macOS, Linux, and Windows: ```sh curl -fsSL https://x.ai/cli/install.sh | bash # macOS / Linux / Git Bash
Primary source ↗Synced from monorepo Changes: - Report invalid MCP server config instead of failing startup - Keep completed terminal output when the gateway connection is lost - Show a duration-only detail view for single-task task output - Don't let a stale registry turn counter hide local sessions - Raise the file-descriptor soft limit on Linux and log effective limits at startup - Stop aborting when HTTP client construction fails - Make session thread and runtime spawn failures recoverable - Fix main-promp
Primary source ↗Synced from monorepo Changes: - Refresh tool search when the managed MCP catalog is re-fetched - Prevent duplicate leader process spawn and startup hang from stale leaders - Document marketplaces, plugins, and organization controls - Stamp session ID on image generation direct-to-API requests - Fix auto mode blocked documentation - Auto mode considers recent user intent - Expose deploy archive, taken-down, limit, and in-progress reasons on the chat API - Fail-closed auth refresh contract for sh
Primary source ↗Synced from monorepo Changes: - Workspace server: report `/ready` as failed with dwell on hub connect failure - Refresh OIDC token for the Grok agent in the shell - ACP terminal output recorder - Cross-platform provider auth commands in the shell - Default `/resume` to Grok sessions with a hint for hidden external sessions - Resume sessions by title with `--resume` - Limit app-builder archive size - Data-driven tag labels for slash commands - Doctor fixes for tmux - Custom provider gateways and
Primary source ↗Changes: - Non-blocking coding-data sharing upsell banner - Consolidate remediation in Doctor - Auto mode defers fail-closed gate asks to the classifier - Coalesce marketplace list fetches - Allow removing a marketplace source by name - Contain hung git marketplace sources (timeouts, non-blocking refresh, unbrick modal) - Label failed workspace RPCs with error_kind - Drop redundant explicit tonic/prost deps from xai-grok-shell - Report real exit codes for completed background shells - Narrow the
Primary source ↗Synced from monorepo Changes: - Shell: accept target response id on rewind execute - Shell: stamp response id on chat user message chunks - Worktree: optional rebuild and stale git registration cleanup in auto-GC - Worktree: kind-aware auto-GC TTLs and config knobs - Worktree: macOS process CWD scan and Unix PID liveness for GC guards - Worktree: automatic throttled GC on startup (Linux age-based; non-Linux dead-only) - Pager: add `[ui].combine_queued_prompts` to batch queued follow-ups - Shell
Primary source ↗Changes: - Persist submitter identity for /feedback - Let custom models use rotating tokens from named auth providers - Template stale tool/param name literals in server-native descriptions - Minimal mode commits thinking in full, lookups as one-liners - Tighten durable append internals - Nudge model to end turn on no-op bash commands - Per-fetch signing nonce in the managed-config envelope, with a server-side replay probe - Include working tree in startup status
Primary source ↗Changes: - Stop hooks for session lifecycle - Add x.ai/session/state and x.ai/session/import ACP methods - Deny-and-continue for auto-mode classifier blocks with denial limits - Drop codebase-upload from dhat soak test - scheduler_create upsert via task_id; retire one-shot tasks - Clipboard: copy file fallback + honest toasts for SSH/Apple Terminal - Polarity-safe syntax colors in minimal mode - Auto mode classifies unvetted env prefixes instead of hard-prompting - Add GROK_CLIPBOARD_NO_OSC52 ki
Primary source ↗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 wh
Primary source ↗Changes: - Classify clipboard delivery confidence - Add durable session update append - Scope the xAI session bearer to first-party memory embedding endpoints - Persist subagent outputs to disk and bound long-lived agent state - Add MiniSweAgent:bash for mini-swe-agent parity - Revert taking local sessions off the persistent shell - Contextual tip recommending grok wrap on SSH sessions - Voice STT bearer from model BYOK env_key/api_key - Define exact website policies for sandbox - Gate unsafe sh
Primary source ↗Changes: - grok-shell: request workspaces:read/write OAuth2 scopes - security: fix SSRF bypass via HTTP redirect in hook runner - fix(grok-build): enterprise STT WSS URL + API-key voice bearer - Harden identity-change purge and sync-marker invariants - sandbox + workspace-server: delete the legacy ready-file arm - Show billing URL when browser cannot open - fix(pager): show folder-trust UI in minimal mode - fix(pager): drain task_backgrounded before no-wait headless exit - grok-agent-sdk: stop S
Primary source ↗initial sync from the monorepo
Primary source ↗[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