Grok Build Plugin

Grok Build ↔ Claude Code Bridge

Bridge Grok Build into Claude Code for review, critique, delegation, and session import.

This repository is a Claude Code marketplace plugin that shells out to the real grok CLI. Run status, results, and stop are owned by the plugin (PID + log files). There is no app-server broker.

Requirements

- Node.js >= 18.18
- Grok Build CLI (grok) on PATH, or set GROK_BINARY
- A logged-in Grok CLI session (grok models succeeds)

Install

Add the marketplace in Claude Code:

Install the plugin:

Reload plugins:

Local install (from a clone)

From this repository root (path must be absolute):

Or, when Claude Code is already open, use /plugin and add the local marketplace path, then install grok-build@xai-grok-build.

Check readiness

Ready means: Node is available, grok is available, and soft auth via grok models succeeds.

Commands

/grok-build:check

Probe Node + Grok CLI availability and authentication.

/grok-build:review

Read-only review of local git state:

Runs:

Optional: pass --model / --effort (low|medium|high). If omitted, Grok chooses defaults.

/grok-build:critique

Same target selection as review, with a design/risk critique prompt and structured JSON output when possible:

Optional: same --model / --effort flags as review.

/grok-build:delegate

Delegate investigation or implementation to Grok via the grok-build:grok-delegate subagent:

Write policy layering:

- Direct node …/grok-bridge.mjs run "…" is therefore read-only unless --write is passed.
- --resume / --resume-last continues the last stored Grok session id via grok -r .
- Prefer bridge --background for long work so runs record both bridgePid (Node worker) and agentPid (grok child).
- /grok-build:stop terminates both process trees when present (agent then…