Dianel555/DSkills / skills/codex-cc
codex-cc
UnverifiedDelegates coding tasks from Codex to local Claude Code in print mode while preserving Claude's normal runtime customizations by default. Use when: (1) You want Codex to call Claude Code locally, (2) You need Claude-side skills, plugins, MCP servers, custom commands, CLAUDE.md rules, or workspace settings to stay active, (3) You want resumable Claude sessions from Codex via SESSION_ID, (4) You need thin `claude mcp` / `claude plugin` passthrough from the same bridge.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 4.0 KB |
| SKILL.md | skill md | 3.6 KB |
| ruff.toml | config | 656 B |
| scripts/claude_bridge.py | script | 21.0 KB |
| tests/test_claude_bridge.py | script | 24.7 KB |
SKILL.md
View on GitHub---
name: codex-cc
description: |
Delegates coding tasks from Codex to local Claude Code in print mode while preserving Claude's normal runtime customizations by default. Use when: (1) You want Codex to call Claude Code locally, (2) You need Claude-side skills, plugins, MCP servers, custom commands, CLAUDE.md rules, or workspace settings to stay active, (3) You want resumable Claude sessions from Codex via SESSION_ID, (4) You need thin `claude mcp` / `claude plugin` passthrough from the same bridge.
---
## Quick Start
```bash
python scripts/claude_bridge.py --cd "/path/to/project" --PROMPT "Analyze auth flow"
```
**Output:** JSON with `success`, `SESSION_ID`, `agent_messages`, `stream_file`
(the raw Claude JSONL stream), and optional `all_messages`, `stderr`, or `error`.
## Runtime Contract
- Default execution uses `claude -p` and does **not** force `--safe-mode`, `--bare`, `--disable-slash-commands`, or `--strict-mcp-config`.
- Claude Code therefore keeps its normal loading path for trusted-workspace customizations such as `CLAUDE.md`, skills, plugins, MCP servers, custom commands, and rules.
- `claude -p` skips the interactive trust dialog and silently ignores invalid settings files, so use this only in workspaces you already trust and whose `.claude` settings already validate.
- The bridge requests `stream-json`, persists each record immediately, and only treats Claude's final `result` record as a completed answer. Intermediate `assistant` records never mask a failed or incomplete turn.
- On Windows the PROMPT is delivered through stdin when `claude` resolves to a `.cmd`/`.bat` shim, so the prompt never passes through cmd.exe quoting and cannot hit the command-line length limit.
## Parameters
```text
usage: claude_bridge.py [-h] --PROMPT PROMPT --cd CD [--SESSION_ID SESSION_ID]
[--model MODEL]
[--permission-mode {,acceptEdits,auto,bypassPermissions,manual,dontAsk,plan}]
[--dangerously-skip-permissions] [--timeout TIMEOUT]
[--stream-file STREAM_FILE] [--return-all-messages]
{mcp,plugin} ...
options:
--PROMPT PROMPT Instruction for the task to send to Claude Code.
--cd CD Workspace root for Claude Code (cwd + --add-dir).
--SESSION_ID SESSION_ID Resume a conversation by session UUID.
--model MODEL Claude model override. Aliases resolve against the active endpoint.
--permission-mode ... Claude permission mode override.
--dangerously-skip-permissions Bypass Claude permission checks.
--timeout TIMEOUT Bridge-level timeout in seconds. Omit for no bridge deadline.
--stream-file STREAM_FILE Raw Claude stream-json JSONL destination.
--return-all-messages Include parsed stream records in the result.
subcommands:
mcp Thin passthrough to `claude mcp`.
plugin Thin passthrough to `claude plugin`.
```
## Sessions
Capture `SESSION_ID` from the first successful response and reuse it for follow-ups.
`SESSION_ID` is empty when a run never established a session (claude produced no stream output):
resume only with an id the bridge actually returned.
```bash
# New Claude session
python scripts/claude_bridge.py --cd "/project" --PROMPT "Inspect failing tests"
# Resume the same Claude session
python scripts/claude_bridge.py --cd "/project" --SESSION_ID "uuid-from-response" --PROMPT "Now propose the fix"
```
## Passthrough
```bash
python scripts/claude_bridge.py mcp list
python scripts/claude_bridge.py plugin list
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |