Repolode
Submit
xai-org

xai-org/grok-build

Grok Build is a terminal AI coding agent from SpaceXAI with a full-screen TUI that edits files, runs shell commands and searches the web.

Open-source alternative to:Claude Code

View on GitHub
Stars
27,477
Forks
5,196
Open issues
0
Last commit
22 days ago

What is it?

Grok Build, invoked as `grok`, is a terminal-based AI coding agent. It runs as a full-screen, mouse-interactive TUI that can understand a codebase, edit files, execute shell commands, search the web and manage long-running tasks. It can also run headlessly for scripting and CI, or be embedded in editors through the Agent Client Protocol (ACP).

The repository holds the Rust source for the CLI/TUI and its agent runtime, organized as a Cargo workspace. Crates cover the TUI rendering, the agent shell with leader, stdio and headless entry points, tool implementations such as terminal, file edit and search, and workspace handling for filesystem, VCS, execution and checkpoints. Prebuilt binaries are published for macOS, Linux and Windows, and the code can be built from source with Cargo after installing DotSlash for the bundled protoc.

External contributions are not accepted. First-party code is Apache-2.0, and vendored third-party code keeps its original licenses.

Key features

  • 01Full-screen, mouse-interactive terminal UI for chatting with the agent.
  • 02Edits files, runs shell commands and searches the web from within the session.
  • 03Headless mode for scripting and CI pipelines.
  • 04Embeds in editors via the Agent Client Protocol (ACP).
  • 05Supports MCP servers, skills, plugins and hooks, per its user guide.
  • 06Prebuilt binaries for macOS, Linux and Windows.

Use cases

  • Delegating multi-file code changes to an AI agent from the terminal.
  • Running a coding agent non-interactively inside CI or scripts.
  • Plugging an AI coding agent into an ACP-compatible editor.

Quick start

  1. 1

    Run the official install script for your OS from the README

  2. 2

    Check that the grok command is installed

    grok --version
  3. 3

    Start the TUI; it opens your browser to authenticate on first launch

    grok

Things to know

  • External contributions are not accepted, so pull requests from outside the team will not be merged.
  • Building from source requires the DotSlash tool, and Windows builds are untested and best-effort.
  • The codebase is synced periodically from a private monorepo, so this public tree may lag behind the latest development.

Topics

#ai-agent#coding-agent#terminal#tui#rust#cli#agent-client-protocol#llm

FAQ

What is grok-build?
Grok Build is a terminal AI coding agent from SpaceXAI with a full-screen TUI that edits files, runs shell commands and searches the web. Grok Build, invoked as `grok`, is a terminal-based AI coding agent. It runs as a full-screen, mouse-interactive TUI that can understand a codebase, edit files, execute shell commands, search the web and manage long-running tasks. It can also run headlessly for scripting and CI, or be embedded in editors through the Agent Client Protocol (ACP).
Is grok-build free to use? What license does it have?
grok-build is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is grok-build still maintained?
Actively maintained. The last commit to grok-build was on Sep 29, 2026.
What can I use grok-build for?
Delegating multi-file code changes to an AI agent from the terminal. Running a coding agent non-interactively inside CI or scripts. Plugging an AI coding agent into an ACP-compatible editor.
How do I install grok-build?
Run the official install script for your OS from the README Check that the grok command is installed: grok --version Start the TUI; it opens your browser to authenticate on first launch: grok
Where can I get grok-build?
The source code and installation instructions are on GitHub: https://github.com/xai-org/grok-build

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects