Engineering / Agent collaboration
Grok for Claude Code
Bounded Grok review and collaboration inside Claude Code.
Archived · 2026-10-05 · No longer maintained. Continued in · turnweft
- 01Define the scope
- 02Delegate the task
- 03Verify the result
01The project
A Claude Code port of the official openai/codex-plugin-cc surface, adapted to drive the local Grok CLI headless mode. It mirrors the same bounded review, adversarial-review, rescue, transfer, status, result, cancel, setup, and optional stop-time review flow while adding the grok:grok-rescue subagent.
02The problem
Claude Code needed a bounded path to ask Grok for review or rescue work without making Grok the owner of local files or git. Manual tool switching weakens scope and evidence tracking.
03Key decisions
I ported the official command surface to Grok CLI headless mode, with job controls, a grok:grok-rescue subagent, stop-time review, and explicit boundaries. Claude Code keeps verification and shipping decisions.
04My contribution
- Current source version 0.3.0: background tasks run in detached persistent workers. Session end or caller timeout does not cancel the job; its saved job ID supports status, result retrieval, and explicit cancellation.
- Claude Code commands for review, adversarial-review, rescue, transfer, status, result, cancel, and setup
- Integration with the Grok CLI's headless mode for bounded second-model review and rescue
More contributions
- grok:grok-rescue subagent plus status/result/cancel controls for inspectable jobs
- 0.2.0 came out of auditing two months of recorded use — 41 surviving job records, 125 tool events, 40 session transcripts. Every run now announces its job id before it starts and carries a hard deadline; a run whose worker died is closed out as an orphan instead of staying 'running' forever; failures carry typed codes, with quota and auth exhaustion holding off further calls; and setup reports leftover 0.1-era job directories rather than deleting them
- Optional stop-time review gate that keeps Claude Code responsible for final verification
05Outcome and current stage
Public v0.3.0 · port of the official codex-plugin-cc surface · Grok CLI headless delegation · optional stop-time review gate
Technical details & evidence
Role · Sole adapter and maintainer of the Claude Code port — Grok CLI headless orchestration, command surface, grok:grok-rescue, job store, failure classification
- JavaScript
- Node.js
- Claude Code Plugin
- Grok CLI
- headless mode