Skip to main content
skill CX Codex

codex · prathamdby — Claude Code skill: run local Codex CLI, how to install

A skill for Claude Code and Codex that runs the local Codex CLI when the agent asks. Triggers when a task requires calling Codex CLI with specific flags and no manual approvals.

MIT 331 installs ★ 6 updated 2026-11-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add prathamdby/skills --skill codex -a claude-code
Open on GitHub

What codex does

The default invocation is codex exec --yolo -C <abs-dir> "<prompt>" with a 15-minute parent wait. Since --yolo bypasses approvals and sandbox, calling this skill counts as consent. Plain codex opens the TUI without --yolo.

Before running, the skill resolves workspace, prompt, mode, session, worktree, sandbox and timeout. It checks the binary and codex login status, blocking on missing auth. --sandbox, --search, --ask-for-approval pass through only when the user names them. --full-auto gets rejected.

After exit, the skill inspects status, diff and runs tests for changed code. Terminal outcomes: SUCCESS, NO_CHANGES, BLOCKED. If the Codex binary is missing, the skill follows its install reference and blocks.

What it helps with

  • run Codex CLI with approvals and sandbox bypassed
  • call Codex in review mode for a specific directory
  • run Codex in a named sandbox without --yolo
  • check codex login status before execution
  • run Codex CLI in a worktree for parallel work

Example prompts for the agent

  • Run Codex in /home/project with the prompt 'fix the tests'
  • Run a Codex review in readonly sandbox
  • Run Codex with model gpt-4o in a worktree

How to install codex

1Skills CLI (Vercel)

npx skills add prathamdby/skills --skill codex -a claude-code

2Manually: put the files in place

~/.claude/skills/codex/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/codex/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about codex

How to install codex in Claude Code?

Run npx skills add prathamdby/skills --skill codex -a claude-code — the skill file lands at ~/.claude/skills/codex/SKILL.md.

What does the codex skill do?

It runs the local Codex CLI on behalf of the agent: resolves parameters, builds the command with the right flags, executes it and verifies the result.

What does the codex skill need to work?

It needs the Codex binary installed and auth via codex login. Without the binary, the skill blocks and points to install instructions.

Source text

SKILL.md · MIT
---
name: codex
description: >
  When the user wants the local Codex CLI run or its installation, login, or connected tools changed.
---

# Codex

## Options and boundaries

Default: `codex exec --yolo -C <abs-dir> "<prompt>"`; model omitted; parent
wait 15m. Calling this skill authorizes that run: pass `--yolo` without asking.
`--yolo` is the listed alias of `--dangerously-bypass-approvals-and-sandbox`;
pass `--yolo`, not both. Bare `codex` is an asked-for TUI and omits `--yolo`.
"Use <model>" adds `-m`. A named sandbox adds `--sandbox <mode>` and omits
`--yolo`. "Worktree" adds boolean `--worktree`, never a name or invented path.
"Review" selects `codex --yolo review` unless a sandbox is named. A named
sandbox omits `--yolo` and uses `codex exec --sandbox <mode> review`.
Missing values or conflicts are `BLOCKED`.

`--full-auto` is rejected. `--search` and `--ask-for-approval` are global,
before `exec`, and only when the user names them. Skip-git-repo-check,
bypass-hook-trust, danger-full-access, approve-for-me, and ignore-rules are
added only when the user names that control. For a named sandbox or a sandbox
failure, follow `references/sandbox.md`. Do not ask, and do not initialize a
repo to evade the git check.

## 1. Resolve

Fix workspace, prompt, mode, session, worktree, sandbox, and wait.
Check binary and `codex login status` without exposing secrets.
Missing binary → follow `references/install.md`; missing auth → `BLOCKED`
unless login was requested. Omit `--sandbox` unless the user named it.
Record `cmd | workspace | mode | session | worktree | wait | evidence | terminal`.
Done when target, binary, auth, and the yolo-or-named-sandbox choice are fixed.

## 2. Run

Build argv, quote the prompt literally, and use `-C` for the target.
Default text is quiet until exit; silence is not a hang. Wait until exit or
the recorded deadline; kill only this run's PID at that deadline.
Nonzero exit: capture stderr, inspect the tree, report `BLOCKED`.
Do not ask the user and do not add a second bypass.

For JSONL/last-message output, follow `references/streaming.md`.
For resume/fork, follow `references/sessions.md`.
For worktrees/parallel runs, follow `references/worktrees.md`.
For review, TUI, login, MCP, or plugins, follow `references/management.md`.
On a rejected flag, use scoped `codex --help` or `codex exec --help`.
Done when the process exits or a named failure is reported.

## 3. Verify and report

Inspect status and diff; CLI text is unverified. Run the narrowest covering
tests for edited executable code. Check every child worktree; a named
read-only sandbox is not a tree-unchanged guarantee. Remove only clean
worktrees this run created and the user did not ask to keep; preserve login,
MCP, and plugins. Report command, mode, session/worktree, wait, and outcome
evidence. Done when every requested outcome is observed or a blocker is evidenced.

Terminals: `SUCCESS`, `NO_CHANGES`, `BLOCKED`.

© prathamdby · MIT · prathamdby/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

codex by other authors comes first.

codex Hermes Agent This skill delegates coding tasks to OpenAI's Codex agent via CLI. Use it to automate features, refactoring, PR reviews, and batch issue fixes directly from the terminal. CX Codex +1 445installs codex softaworks Runs Codex CLI for code analysis, automated refactoring and file editing. Defaults to GPT-5.2 with configurable reasoning depth and sandbox modes. CX Codex +1 4,100installs codex typeui.sh codex enforces a radically minimal monochrome design system and generates component specifications compliant with WCAG 2.2 AA. CX Codex +1 2,700installs codex giuseppe-trisciuoglio Delegates complex code generation, refactoring, and code reviews to the Codex CLI using GPT-5.3-codex, o3, or o4-mini models. CX Codex +1 3,600installs codex yan-labs Skill to launch Codex CLI as a background agent with sandbox, reasoning effort, and parallel worker control. Use when you need direct access to codex review, codex apply, or multi-threaded code analysis. CX Codex +1 ★ 313repo stars docker-agent-run docker Walks through docker agent run: picking a safety mode, isolating the agent in a sandbox, aliases, and failed runs. CX Codex +1 1,100installs app-verification mblode app-verification — a skill for Claude Code, Codex, Cursor and other agents that scaffolds a project-local verification harness — verify, doctor, and seed commands — inside the target repository. CX Codex +1 217installs worktree FlorianBruniaux Creates a separate git worktree folder for feature or fix branches. Useful when you need to work on multiple tasks in parallel without conflicts in your main branch. CX Codex +1 ★ 6,529repo stars om-auto-create-pr open-mercato om-auto-create-pr converts an arbitrary task brief into an autonomous development run, from execution tracking to a ready PR. Operates in an isolated git worktree with incremental commits. CX Codex +1 4,700installs om-auto-continue-pr-loop open-mercato The om-auto-continue-pr-loop Claude Code skill resumes an unfinished PR run started with om-auto-create-pr-loop. It picks up at the next incomplete plan task and carries the work through final checks. CX Codex +1 4,600installs afk jakubkrehel afk is a Claude Code skill that inspects your repository while you are away, implements verified improvements on a dedicated branch, and writes a concise report. CX Codex +1 3,900installs

From the same set19

The whole set →
orchestrate The orchestrate skill for Claude Code splits work among subagents; the parent agent sets scope, verifies results, and integrates them without editing product files or delegating its duties. CX Codex +1 618installs recon The recon Claude Code skill reads, creates, or refreshes a saved repository map. It keeps that map outside the project and backs its claims with evidence. CX Codex +1 603installs gh The gh skill lets an agent inspect PRs, discussions, and CI, post replies, and handle GitHub commands that need more than a simple call. CX Codex +1 420installs cursor-agent A skill for Claude Code, Codex, and Cursor runs the local cursor-agent CLI and checks its outcome. It handles tasks involving CLI modes, sessions, and worktrees. CX Codex +1 347installs claude-code This Claude Code skill runs the local CLI with selected options and checks the result. It also handles requests to change installation, sign-in, or connected tools. CX Codex +1 329installs upfront-design upfront-design — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that runs structured design sessions before any code is written. It pauses after each of five phases until the user approves the output. CX Codex +1 321installs todoist-task Creates Todoist tasks directly from your editor. Recognises task requests, resolves project and date details, shows a preview before creating, and verifies the result in Todoist. CX Codex +1 315installs use-skill use-skill pulls a skill from a GitHub link, checks its structure and runs the steps in a temp folder. Nothing lands in your project. CX Codex +1 294installs

Project sponsors

Companies that keep this analytics open