Skip to main content
hook CX Codex

cc — Claude Code hook: Codex bridge for reviews and background jobs

cc — a hook bridge between Claude Code and Codex. It runs reviews, rescue tasks and tracked background jobs from Claude Code inside a Codex session.

Apache-2.0 ★ 1,596 updated 2026-10-29

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/settings.json
Open on GitHub

What cc does

The cc plugin connects Claude Code to Codex. It is the reverse of OpenAI's official Claude-hosted plugin: here Codex drives Claude Code for code reviews, rescue tasks and tracked background jobs.

Four hooks sit on SessionStart, SessionEnd, Stop and UserPromptSubmit. Session lifecycle events run session-lifecycle-hook.mjs through node. The Stop event triggers stop-review-gate-hook.mjs with a 900-second timeout, so the session cannot close until the review gate passes. On prompt submit, unread-result-hook.mjs checks for results from Claude Code.

Setup goes through .claude/settings.json, where the hooks are registered in the Claude Code config. Scripts live in $PLUGIN_ROOT/hooks/ and need node available. Claude Code itself must be on the machine for Codex to use it.

What it helps with

  • run Claude Code reviews from a Codex session
  • block Stop until the review gate finishes
  • track Claude Code background jobs
  • pick up Claude Code results on prompt submit
  • bridge two agents without manual switching

Example prompts for the agent

  • Review this file through Claude Code from the current Codex session.
  • Check for unread results from Claude Code.
  • Set the review gate so Codex cannot end the session before the check passes.

How to install cc

Manually: put the files in place

.claude/settings.json

The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command

Questions about cc

How do I install cc in Claude Code?

Add the hooks to .claude/settings.json. Scripts are invoked with node "$PLUGIN_ROOT/hooks/...", so node must be installed.

What does the cc hook do?

It links Claude Code with Codex for reviews, rescue tasks, background jobs and a review gate on Stop.

Which events does cc intercept?

Four: UserPromptSubmit, SessionStart, SessionEnd and Stop. The Stop hook runs the review gate with a 900-second timeout.

Source text

hooks.json · Apache-2.0
Hooks bundle shipped with the cc plugin for Claude Code.

Reverse of OpenAI's official Claude-hosted plugin: use Claude Code from Codex for reviews, rescue tasks, tracked background jobs, and hook-powered review gates.

Triggers on: UserPromptSubmit, SessionStart, SessionEnd, Stop.

```json
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$PLUGIN_ROOT/hooks/session-lifecycle-hook.mjs\"",
            "statusMessage": "Initializing Claude Code bridge"
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$PLUGIN_ROOT/hooks/session-lifecycle-hook.mjs\"",
            "timeout": 3,
            "statusMessage": "Closing Claude Code bridge"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"$PLUGIN_ROOT/hooks/stop-review-gate-hook.mjs\"",
            "timeout": 900
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$PLUGIN_ROOT/hooks/unread-result-hook.mjs\"",
            "statusMessage": "Checking for unread Claude Code results"
          }
        ]
      }
    ]
  }
}

```

© Sendbird, Inc. · Apache-2.0 · hashgraph-online/awesome-codex-plugins

Similar hooks

All hooks for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
development-skills This hook routes development work through three tiers, formats file changes, and sends each change to a staff-reviewer subagent. It supports Claude Code and Codex. CX Codex ★ 1,596repo stars devin Session lifecycle hooks for Claude Code: track start and end, gate stops with a review, and hand tasks off to Devin's cloud. CX Codex ★ 1,596repo stars deepseek-minimal-anchor deepseek-minimal-anchor adjusts DeepSeek default reasoning behavior in Claude Code and Codex. It injects working anchors at session start, guides prompts per turn, and logs trajectory reports. CX Codex ★ 1,596repo stars debt-ops The debt-ops hook records deferred tech-debt items in a repository registry, while a review skill ranks them by file churn. Use it to keep postponed cleanup visible during coding. CX Codex ★ 1,596repo stars babok_analyst babok_analyst is a Claude Code hook bundle that manages the BABOK v3 business analysis agent’s session lifecycle and controls MCP tool execution through approval gates. CX Codex ★ 1,596repo stars archcore archcore is a Claude Code hook that brings Git project context into spec-driven development. It runs at session start, before file edits, and after Archcore document operations. CX Codex ★ 1,596repo stars aiboarding aiboarding is a Claude Code and Codex hook that generates, maintains, compresses, and audits AI-agent onboarding files, keeping AGENTS.md and CLAUDE.md current as the codebase changes. CX Codex ★ 1,596repo stars ai-sdlc ai-sdlc — a hook bundle for a six-stage Markdown SDLC in Claude Code. It checks tool calls to block unauthorized file edits and safeguard sensitive project paths. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open