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:
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
Related
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:
Users who want Grok-backed agents must configure a custom harness command instead of selecting Grok from Agent runtimes / onboarding.
Why
grok agent stdio) — no separate*-acpnpm adapter is required (same class of integration as Goose'sgoose acp/ Cursor's native ACP path).curl -fsSL https://x.ai/cli/install.sh | bash, binary under~/.grok/bin).Proposed solution
Register Grok Build in
KNOWN_ACP_RUNTIMESwith:idgroklabelcommandsgrokagent --always-approve stdio~/.grok/bin.grok/skillsgrok loginorXAI_API_KEYAlso wire onboarding visibility, docs (
buzz-acpREADME / TESTING), and unit tests for arg normalization.Acceptance criteria
grokis on PATHgrok agent … stdioviabuzz-acpbuzz-acp modelswithBUZZ_ACP_AGENT_COMMAND=grokcompletes an ACP handshakeRelated
grok agent stdio/ Agent Client Protocol mode