Skip to content

v1.1.0 — Codex CLI support

Choose a tag to compare

View all tags
@taibaran taibaran released this 18 May 12:51
v1.1.0
e75755f

The plugin now installs in both Claude Code and OpenAI's Codex CLI from a single repo.

No companion.mjs changes were needed: Codex sets CLAUDE_PLUGIN_ROOT for back-compat with CC's plugin contract, so the existing commands/agents/hooks layout already runs inside Codex. v1.1.0 ships the manifest and skill metadata that make the plugin discoverable by Codex's marketplace + skill router.

Install in Codex CLI

codex plugin marketplace add taibaran/grok-plugin-cc

After install, the model auto-routes to the matching skill on intent:

  • "Ask grok…" → grok-ask (live web search)
  • "Research…" → grok-research (effort=max + --check self-verification)
  • "Generate an image of…" → grok-imagine
  • "Delegate this to grok…" → grok-rescue (read-only; GROK_PLUGIN_ALLOW_WRITE=1 for edits)

Install in Claude Code (unchanged)

/plugin marketplace add https://github.com/taibaran/grok-plugin-cc
/plugin install grok@grok-plugin-cc
/grok:setup

Full slash-command surface (/grok:ask, /grok:research, /grok:imagine, /grok:rescue, /grok:review, /grok:best-of, /grok:aggregate-review, /grok:sessions, /grok:memory, /grok:mcp, /grok:status, /grok:result, /grok:cancel, /grok:purge, etc.) all unchanged.

What's new

  • .agents/plugins/marketplace.json — Codex marketplace manifest at repo root.
  • plugins/grok/.codex-plugin/plugin.json — Codex-native plugin manifest with interface block (displayName, category, capabilities, defaultPrompt) so the Codex TUI surfaces the plugin properly.
  • 4 user-facing skills (grok-ask, grok-research, grok-imagine, grok-rescue) that Codex's (and CC's) skill router auto-invokes by intent. All four shell out to the same scripts/companion.mjs.
  • README documents the Codex install command and a comparison table of CC slash commands vs Codex skills.
  • 9 new structural tests pinning manifest schemas, version lockstep across all four manifest files, and skill metadata.

Numbers

  • 405 tests → 400 pass + 5 skipped (integration tests requiring real Grok auth).
  • No behavior change to companion.mjs, hooks, or existing slash commands.
  • v1.0.6 fixes carry forward (runJob silent-on-exit-0 + cross-plugin state-dir collision).

Compatibility

  • CC users keep the full slash-command surface unchanged.
  • Codex users get equivalent functionality via auto-invoked skills.
  • The 3 internal skills (grok-cli-runtime, grok-prompting, grok-result-handling) remain user-invocable: false and are inert in Codex (they were only ever called from CC's grok-rescue subagent).
Assets 2
Loading