feat(grok): add Grok CLI provider via ACP

[Jaaneek]

What Changed

#2808
Add Grok Build via ACL

Why

Grok Build was recently released and its accessible via X Premium Subs and Supergrok Subs

UI Changes

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

---

Note

Medium Risk
New provider spawns Grok child processes for chat, probes, and text generation; Grok defaults to enabled in settings, so fresh installs may probe the CLI immediately. Auth and subprocess handling are security-sensitive but follow existing ACP driver patterns.

Overview
Adds Grok as a first-class provider using the Grok CLI over ACP (grok agent stdio), alongside existing Codex/Cursor-style drivers.

Server: New GrokDriver wires adapter, snapshot health (grok --version + ACP model discovery), and GrokTextGeneration for git/thread helpers. GrokAdapter runs full chat sessions: ACP lifecycle, session/set_model, permissions (auto-approve in full-access), streaming runtime events, image attachments, and resume cursors. Shared ACP runtime gains setSessionModel; Grok-specific spawn/auth (GROK_OAUTH2_REFERRER=t3code, API key vs cached token) lives in GrokAcpSupport.

Contracts & defaults: GrokSettings (enabled, binaryPath, customModels), server settings patches, default model grok-build, and registry/tests updated so Grok boots with other built-in drivers.

Web: Grok in provider picker (Early Access / new badge), settings form metadata, and GrokIcon.

Tests / mock: acp-mock-agent advertises Grok models and implements session/set_model; unit/integration tests cover adapter, provider probes, and headless text generation.

^{Reviewed by Cursor Bugbot for commit a58e850. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add Grok CLI provider via ACP with session management, text generation, and UI integration

• Introduces a full Grok provider driver (GrokDriver.ts) that probes the grok CLI binary, discovers models via ACP, and emits disabled/error/ready provider snapshots with a 15s ACP discovery timeout and 4s version check timeout.
• Adds a GrokAdapter.ts implementing the full session lifecycle: start/stop, turn streaming, permission auto-approval, model switching via session/set_model, and ACP event translation to runtime events.
• Adds GrokTextGeneration.ts for commit messages, PR content, branch names, and thread titles via a 180s-timeout ACP JSON prompt loop with structured decoding.
• Registers Grok in contracts (model.ts, settings.ts), the built-in driver registry, provider picker (with a 'new' badge), settings UI, and chat icon map.
• Extends the ACP mock agent to support session/set_model and model state reporting for use in integration tests.

^{Macroscope summarized a58e850.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: ae8e6de9-4b2b-4a6f-93e0-d429d872ac19

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 30e7372. Configure here.}

[cursor]

Concurrent turns during Grok prompt

Medium Severity

The per-thread lock in sendTurn covers preparation and turn.started but not the in-flight session/prompt. A second sendTurn on the same thread can acquire the lock and start another ACP prompt while the first is still running, interleaving two turns on one Grok ACP session.

 

^{Reviewed by Cursor Bugbot for commit 30e7372. Configure here.}

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a complete new Grok provider integration with substantial new logic (~2600 lines) including driver, adapter, text generation, and UI components. New feature integrations of this scope require human review, and there is also an unresolved comment identifying a potential concurrency issue in turn handling.

^{You can customize Macroscope's approvability policy. Learn more.}