Guac Build

Guac Build is a Muse Spark 1.1-powered terminal coding agent. It runs as a
full-screen TUI that understands your codebase, edits files, executes shell
commands, searches the web, and manages long-running tasks — interactively,
headlessly for scripting/CI, or embedded in editors via the Agent Client
Protocol (ACP).

Quick start ·
Documentation ·
Repository layout ·
Development ·
Contributing ·
License

[!WARNING]
Experimental — not production-ready. Guac Build started as a random idea.
The guac binary builds and passes an end-to-end smoke test against an
in-tree mock inference server, but it has not been exercised against the
live Meta Model API. Treat it as a work in progress.

This is an independent fork of
xai-org/grok-build.

The fork keeps Grok Build's Rust harness and local tools, replaces the default
model/provider with Meta's
muse-spark-1.1, enables
Meta Model API search grounding, and removes xAI's hosted x_search from the
default agent.

The original internal crate names are intentionally retained to keep upstream
rebases reviewable. Product-facing behavior, the executable, configuration
home, provider, and default model are Guac Build.

---

Quick start

Meta Model API is currently available in public preview for US developers.
Create an API key at Meta's developer portal,
then export it:

export MODEL_API_KEY="..."

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://