Chutes Build

What this is, and what it is built on

Chutes Build is a fork of xai-org/grok-build — SpaceXAI's Grok Build — re-based onto upstream 1.0.0 and adapted to run on Chutes. Upstream wrote most of the code in this tree and it is used here under Apache-2.0; the project is not affiliated with or endorsed by SpaceXAI.

What the fork changes:

• Chutes, not xAI. Inference goes to llm.chutes.ai, the model catalog is Chutes', the default route is Chutes' native model routing (the saved default pool, or an inline pool via CHUTES_ROUTING_POOL), and media generation, OCR, usage and quota all go through Chutes APIs.
• Nothing phones home. Telemetry, remote error reporting, upload, session sharing, remote workspace exposure and self-update are off at compile time and their endpoints are deadened, not merely unused. See PRIVACY.md.
• A few exclusive features: Chutes media generation and editing, OCR, voice input through a Chutes STT endpoint, Context7 documentation lookup, and an isolated browser tool.

Everything else is meant to track upstream closely, so their fixes arrive by merge rather than by hand. docs/upstream-sync.md documents that procedure and records each sync; .github/upstream.json records the commit this tree is level with. SOURCE_REV is inherited from upstream's published tree and refers to their monorepo, not to anything in this repository.

Installing

Via npm, which fetches the binary for your platform:

npm i -g chutes-build
chutes-build --version

Or build from source below.

From 1.0.0 on, each release also carries the six platform executables as downloadable assets. Earlier releases (0.4.x) carry release notes only — npm is the way to install those.

There is no self-update: chutes-build never contacts an update server, and the update subcommand reports where to get a newer version rather than fetching one. CHANGELOG.md records what changed 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.

• Windows, macOS and Linux all build. Windows is where this tree is developed and gated, and it needs the vendored protoc fallback carried here — upstream 1.0.0 does not build on Windows at all, because bin/protoc is a DotSlash wrapper the platform cannot execute from a build script.

cargo run -p chutes-build              # build + launch the TUI
cargo build -p chutes-build --release  # release binary: target/release/chutes-build
cargo check -p chutes-build            # fast validation

The binary artifact is named xai-grok-pager; official installs ship it as chutes-build. On first launch it asks for a Chutes API key — the primary credential, created at chutes.ai/app/api and also readable from CHUTES_API_KEY. Browser login is opt-in and needs an OAuth app you register yourself; see the authentication guide.

Documentation

The documentation lives in this repository. There is no separate site: an earlier link to docs.chutes.ai/build/overview was a 404 dressed as a promise.

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

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