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
.claude/settings.jsonWhat 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.jsonThe 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