A Grok Build plugin that delegates tasks to local Claude Code or Codex CLI, letting users leverage external AI coding agents directly from a Grok session.

Stars

13

7-day growth

No data

Forks

1

Open issues

0

License

MIT

Last updated

2026-07-14

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It seamlessly integrates two powerful AI coding tools (Claude Code and Codex) into Grok Build, enabling complex code generation and analysis without leaving the Grok interface, while providing safety defaults and clean background task management.

Who it is for

  • Grok Build users who want to extend its capabilities with external AI agents
  • Developers already using Claude Code or Codex who want a unified chat interface
  • Teams practicing AI-assisted development and code review workflows
  • Plugin developers looking for a reference implementation of a Grok Build delegate plugin

Use cases

  • Performing automated code reviews on a repository via `/delegate-claude review` or `/delegate-codex review`
  • Implementing specific code changes (rescue) with detailed instructions while keeping full session context
  • Mapping a project's structure, entry points, and purpose with the `overview` action
  • Running adversarial code reviews with a deliberately skeptical brief to catch subtle issues

Strengths

  • Provides two convenient slash commands (`/delegate-claude`, `/delegate-codex`) with consistent actions across both engines
  • Supports multiple predefined actions (setup, overview, review, adversarial, rescue) with runtime model and effort discovery
  • Ensures safety with read-only defaults for non-write actions and restricted write permissions for rescue (no shell by default)
  • Cancels tasks cleanly by terminating the entire engine process group, preventing orphaned processes

Considerations

  • Requires Node.js 18+ and Linux or macOS (Windows only if `GROK_DELEGATE_ALLOW_WINDOWS=1` is set)
  • Depends on the user having `claude` and/or `codex` CLI installed, authenticated, and on the PATH
  • Default write permissions are intentionally narrow (no shell for Claude rescue, workspace-write sandbox for Codex), which may limit complex use cases

README quick start

grok-delegate

grok-delegate is a Grok Build plugin that hands work to local Claude Code or Codex while you stay in the Grok session.

The delegate runs as a normal background task: tools and progress stream into the task log, the result comes back when it finishes, and canceling the task stops the engine’s whole process group so nothing is left orphaned.

This repository is the Grok Build Extras marketplace. The installable plugin package is under plugins/delegate/.

▶ Full demo (MP4, ~49s) · also in-repo as assets/demo.mp4


What you get

Two slash commands — /delegate-claude and /delegate-codex — that hand a job to the matching local CLI without leaving Grok. Progress shows up in the background-task pane the same way any other long Grok job does: starting, thinking, tool, writing, completed. When the run finishes, the answer is in that task. When you cancel it, the companion stops the whole engine process group so nothing is left running in the background.

Both commands share the same actions:

ActionIntentCan write files?
setupCheck that the CLI is installed, authenticated, and what models it knows aboutNo
overviewMap the repo — purpose, layout, entry pointsNo
reviewReview the current git scope for concrete problemsNo
adversarialSame as review, with a deliberately skeptical briefNo
rescueImplement a specific changeYes, under the defaults below

Put flags before --. Everything after -- is focus text for the delegate, never options. Models and effort levels are read from your installed CLIs at runtime, not hard-coded in the plugin.

/delegate-claude setup
/delegate-codex setup

/delegate-claude overview --model sonnet --effort low --trust-project --
/delegate-codex review --model gpt-5.6-sol --effort high -- focus on auth

/delegate-claude rescue --model opus --effort high -- fix the flaky pagination test
/delegate-codex rescue -- implemen

Description

Grok Build plugin: hand work to local Claude Code or Codex as a background task

Related repositories

Similar projects matched by category, topics, and programming language.

7-e1even
Featured
7-e1even GitHub avatar

learn-agent

A collection of notes on building coding agents, derived from the production development of the desktop agent Reina, with each mechanism simplified into a zero-dependency, single-file Node.js demo.

AI & Machine LearningLarge Language Models
218
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577