local-codex
Launches and manages the local OpenAI Codex CLI as a non-interactive coding sub-agent via ChatGPT OAuth, never API keys. Use to delegate coding tasks to Codex, run codex exec, generate or refactor code, or get a Codex code review; phrases like 'codex', 'run codex', 'codex exec', 'delegate to codex'.
Install / Use
npx skills add daymade/claude-code-skills --skill local-codexInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of local-codex
local-codex scores 92/100 on our quality scale, 290th of 947 AI & Machine Learning skills we index (top 31%).
Its SKILL.md is 6.4 KB long, well organised into 15 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
With 1,426 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so local-codex is actively maintained.
- Our last check on 2026-10-27 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
local-codex compared with similar skills
All 4 of these similar skills score higher than local-codex; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| local-codex (this skill)by daymade | 92 | 1.4k | 53d ago | SKILL.md |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install local-codex?
- Run
npx skills add daymade/claude-code-skills --skill local-codex. The install tabs above show the steps for each supported agent. - Which AI agents does local-codex work with?
- It is written for Zed and OpenAI Codex, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is local-codex safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is local-codex still maintained?
- The repository was last updated about 2 months ago, so local-codex is actively maintained.
Skill content
View source on GitHubname: local-codex description: >- Launches and manages the local OpenAI Codex CLI as a non-interactive coding sub-agent via ChatGPT Pro OAuth, never API keys. Use to delegate coding tasks to Codex, run codex exec, generate or refactor code, or get a Codex code review; phrases like 'codex', 'run codex', 'codex exec', 'delegate to codex'.
Local Codex
Delegate coding tasks to the local OpenAI Codex CLI agent using your ChatGPT Pro subscription (OAuth, no API charges).
When to Use
- User wants to generate, refactor, or review code via Codex
- User wants to run
codex execfor non-interactive tasks - User wants to use Codex's GPT-5.5 agent capabilities
- User mentions "codex", "run codex", "delegate to codex"
Authentication (OAuth / ChatGPT Pro)
CRITICAL: This skill uses OAuth authentication from ~/.codex/auth.json (ChatGPT Pro flat-rate subscription). Do NOT set OPENAI_API_KEY or pass API keys — that would switch to pay-per-use billing.
- The ChatGPT.app desktop bundle and CLI share the same auth cache
- If auth fails, run
codex loginin terminal (browser OAuth flow) - For auth issues, see references/oauth-guide.md
Codex CLI Path
The skill auto-detects Codex CLI in this order:
CODEX_BINenv var, if set — explicit override. A non-executable path fails loudly instead of silently falling through to a different build (that would make whatever the wrapper measured unattributable).which codex— whatever is first on PATH. This is the build the surrounding environment actually runs, so it is the right default: npm global installs under nvm (~/.nvm/versions/node/*/bin/codex) resolve here./Applications/ChatGPT.app/Contents/Resources/codex— the copy bundled inside ChatGPT.app, fallback only. Its version tracks the Desktop app and can diverge from the npm build, so it is deliberately last.
If a bad CODEX_BIN was set, the wrapper exits 1 with
{"error": "CODEX_BIN not executable", "path": <value>} — the offending value is in
the error itself, and searched_paths is not emitted for this case (no other search
step ran). If neither PATH nor the app bundle has a codex, the wrapper exits 1 with
the actual search order in searched_paths.
Whichever binary wins, attribute behaviour to it by versioning the binary that
ran, not codex --version: the bare command always resolves the PATH copy, which is
the wrong build to quote when the fallback picked the app-bundled one. Use the
codex_path field from the wrapper's status output:
"<codex_path from status output>" --version
Two builds on one machine is the normal state, not an anomaly.
Usage Patterns
1. Basic exec (single task)
python3 scripts/codex_wrapper.py exec "<prompt>" [<workdir>] [<model>] [<sandbox>] [<timeout>]
Example:
python3 scripts/codex_wrapper.py exec \
"Write a Python function to calculate fibonacci" \
/tmp \
gpt-5.5 \
workspace-write \
300
2. Code review
python3 scripts/codex_wrapper.py review [<workdir>] [<model>] [uncommitted:true] [<timeout>]
Example:
python3 scripts/codex_wrapper.py review \
/path/to/repo \
gpt-5.5 \
true \
300
3. Check status
python3 scripts/codex_wrapper.py status
Output Format
The wrapper returns JSON with:
success: boolexit_code: intelapsed_seconds: floatstdout: raw outputstderr: error stream (truncated)parsed_jsonl: parsed JSONL events (if --json)final_message: extracted assistant text (if available)
Parameters
| Parameter | Default | Options |
|-----------|---------|---------|
| model | gpt-5.5 | gpt-5.5, gpt-5.5-pro, o4-mini, etc. |
| sandbox | workspace-write | read-only, workspace-write, danger-full-access |
| timeout | 300 | seconds (increase for large tasks) |
| json_output | true | always true (wrapper parses JSONL) |
Safety Notes
sandbox=read-onlyfor analysis/review tasks (no file writes)sandbox=workspace-writefor code generation (writes to working dir)sandbox=danger-full-accessonly when explicitly needed (full system access)- Always use
--skip-git-repo-checkwhen running outside git repos - Use
--ephemeralfor one-off tasks (no session persistence)
Session Management
For multi-step tasks, Codex supports session resume:
# First step
codex exec --ephemeral "Step 1..."
# Later
codex exec resume --last "Step 2..."
The wrapper currently runs single-shot exec. For multi-step workflows, use raw codex exec commands.
Limitations
- Desktop app must be running for OAuth token refresh (or token must be fresh)
codex doctorworks and is the first thing to run when Codex misbehaves. Run it without--summary—--summarycuts reachability down to a bare✗ reachability ... unreachableline (it actually prints twice, once under Notes and once under Connectivity) with no host and no remedy, in both the fail and the warning state. The full form names the host, the endpoint statuses, and a→ check proxy, ...remedy line, likewise in both states; what differs between fail and warning is which endpoint failed and whether it is marked(required). For--json, everything lives underchecks["network.provider_reachability"]:detailsmaps endpoint → status, andissuesis a list whose objects carryseverity/cause/measured/expected/remedy/fields(the last three are optional). Two traps: there is no top-levelissueskey at all — do not writereport["issues"](KeyError) orreport.get("issues")(silently None); and a check's ownissueskey is omitted entirely when empty rather than sent as[], socheck.get("issues")returns None for the 20+ checks that have nothing to report. Top level has exactly 5 keys,generatedAtis a string like"1790057704s since unix epoch"rather than a timestamp, and exit 1 fires on any failed check, not just reachability —rollout_db_parityis ⚠ on this install, and if it ever flips to fail it turns that exit code red for a reason unrelated to your network, which is what gates likecodex-1m-context-window-setup'sreturncode == 0check read. Verified 2026-09-22 on 0.155.1 (npm) and 0.155.0-alpha.9.2 (ChatGPT.app-bundled); the remedy wording quoted here is specific to those builds — upstream has since changed it.- Environment variables are NOT inherited into Codex's sandbox; pass via config or prompt
- Large file operations may need increased timeout
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
