local-codex
Launch and manage OpenAI Codex CLI (local agent) as a non-interactive coding sub-agent. Use when the user wants to delegate coding tasks to Codex, run code reviews, generate or refactor code, or use Codex GPT-5.5 agent capabilities through local CLI. Triggers on phrases like 'codex', 'run codex', 'codex exec', 'code review with codex', 'delegate to codex', 'use codex for coding', or any request to invoke the local Codex CLI agent. Uses ChatGPT Pro OAuth (flat-rate, no API charges) via ~/.codex/auth.json. Never uses API keys.
pinned to #029876dupdated last month
Ask your AI client: “install skills/local-codex”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/local-codexmetahub onboarded this repo on the author's behalf.
If you own github.com/daymade/claude-code-skills on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
1,331
Last commit
last month
Latest release
published
About this skill
Pulled from SKILL.md at publish time.
Delegate coding tasks to the local OpenAI Codex CLI agent using your ChatGPT Pro subscription (OAuth, no API charges).
Automated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.029876d· last month
Behavioral checks ran but aren't published for this artifact; the static checks above ran at publish time.
Documentation
7 passed2 warningsTags / topics declaredwarn
No manifest tags and no GitHub repo topics
Add tags to the manifest (or GitHub topics on the repo) so the registry's search and category filters surface this artifact.
Homepage or repository declaredwarn
No homepage or repository declared.
Add a "homepage" or "repository" field to SKILL.md.
Description quality
84 words · 530 chars — "Launch and manage OpenAI Codex CLI (local agent) as a non-interactive coding sub…"
README is present and substantial
182,381 chars · 15 sections · 88 code blocks
README has usage / example sections
found: Example
Homepage / docs URL declared
no homepage declared (registry will use the repo URL) — info-only, not blocking
Description is substantive
Description is 84 words.
Documentation present and substantive
Documentation present (SKILL.md, 552 words).
Documentation shows usage
Documentation includes 6 code examples.
Release history
1- releasecurrent029876dwarnlast month
Contents
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.
- Codex desktop app 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:
/Applications/Codex.app/Contents/Resources/codex(desktop app)/usr/local/bin/codex(npm global)/opt/homebrew/bin/codex(Homebrew)~/.npm-global/bin/codexwhich codexfallback
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 doctoris buggy in current version (alpha), avoid using- Environment variables are NOT inherited into Codex's sandbox; pass via config or prompt
- Large file operations may need increased timeout
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/local-codex