Skip to content

feat(agents): add Grok Build as a first-class ACP runtime #2347

Description

@daniel-farina

Summary

Buzz Desktop's managed agent runtime catalog supports Goose, Claude Code, Codex, and Buzz Agent, but Grok Build is missing even though it already speaks ACP natively over stdio:

grok agent stdio

Users who want Grok-backed agents must configure a custom harness command instead of selecting Grok from Agent runtimes / onboarding.

Why

  • Grok Build ships a stable ACP server (grok agent stdio) — no separate *-acp npm adapter is required (same class of integration as Goose's goose acp / Cursor's native ACP path).
  • Install path is well-known (curl -fsSL https://x.ai/cli/install.sh | bash, binary under ~/.grok/bin).
  • Without catalog registration, Desktop cannot discover, install-hint, or process-sweep Grok the way it does other runtimes.

Proposed solution

Register Grok Build in KNOWN_ACP_RUNTIMES with:

Field Value
id grok
label Grok Build
commands grok
Default args agent --always-approve stdio
PATH discovery include ~/.grok/bin
Skills .grok/skills
Auth hint grok login or XAI_API_KEY

Also wire onboarding visibility, docs (buzz-acp README / TESTING), and unit tests for arg normalization.

Acceptance criteria

  • Grok Build appears under Desktop → Agent runtimes when grok is on PATH
  • Creating/starting a managed agent with runtime=Grok spawns grok agent … stdio via buzz-acp
  • buzz-acp models with BUZZ_ACP_AGENT_COMMAND=grok completes an ACP handshake
  • Docs describe the Grok path alongside Goose/Claude/Codex

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions