Local Codex
Delegates coding, refactoring, and review tasks to your locally installed OpenAI Codex CLI as a non-interactive sub-agent.
Dev & CodingIntermediate★ 1,323⑂ 212AI score 8/10Last updated: Aug 8, 2026
What it does
- Auto-detects the
codexCLI (desktop app, npm global, Homebrew, PATH fallback) and runs it non-interactively. - Wraps three standardized commands in a Python helper:
exec(single task),review(code review, optionally uncommitted-only), andstatus. - Returns structured JSON (
success,exit_code,elapsed_seconds,stdout,final_message) so Claude can chain the result into follow-up work. - Uses ChatGPT Pro OAuth from
~/.codex/auth.jsonand explicitly avoids API keys, keeping usage on the flat-rate subscription. - Exposes model, sandbox level (
read-only,workspace-write,danger-full-access), and timeout as parameters.
Who it's for
- Developers with a ChatGPT Pro subscription who want Codex and Claude to cross-check each other.
- Anyone offloading repetitive refactors or reviews to a second agent without leaving their main session.
- Teams that want automated review of uncommitted diffs before pushing.
Examples
- "Have codex review the uncommitted changes in this repo" → runs
review /path/to/repo gpt-5.5 true 300and summarizes the findings. - "Ask codex to write a Python fibonacci function" →
execwithworkspace-writesandbox writes the file into the working directory. - "Check the codex connection" →
statusreports the resolved CLI path and OAuth health.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the local-codex folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/local-codex/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/local-codex ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Install the OpenAI Codex CLI first (Codex desktop app,
npm i -g @openai/codex, or Homebrew). - Run
codex loginin a terminal and complete the browser OAuth flow with your ChatGPT Pro account. Do not setOPENAI_API_KEY— that switches you to pay-per-use billing. - Confirm Python 3 is available with
python3 --version. - Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Copy the skill folder:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/local-codex ~/.claude/skills/ - Restart Claude Code and try asking "check codex status" to confirm the skill loads.
- Start with the
read-onlysandbox, useworkspace-writeonly when files must change, and avoiddanger-full-accessunless strictly required.
View source on GitHub ↗License: MIT