About codex-cli
codex-cli is an agent skill for detecting, installing, configuring, and running OpenAI Codex CLI as a background coding agent. It handles code editing, PR reviews, issue fixes, and one-shot automation tasks.
Key features
- 01Codex CLI setup and configuration
- 02Background coding-agent execution
- 03Code editing and PR review
- 04Issue fixing and one-shot automation
Use cases
- 01Reviewing a specified pull request
- 02Fixing a bug with Codex CLI
- 03Running a one-off code change
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ cowork-os/ cowork-os --skill codex-cliAfter installing, type/codex-cliin Claude Code to confirm it loaded.
Bundled filesreferences/full-guidance.md
Details
From the project READMEcodex-cli
Purpose
Detect, install, configure, and run the OpenAI Codex CLI (codex) as an autonomous background agent for code editing, PR review, issue fixing, and one-shot automation tasks.
Routing
- Use when: User wants to run Codex CLI, asks for "codex agent", "spin up codex", "codex review", "codex fix", or wants to execute a coding task using the OpenAI Codex CLI specifically.
- Do not use when: The request is for planning, discussion, or non-executable output.
- Outputs: Task result from Codex CLI agent, or setup instructions if CLI is not installed/configured.
- Success criteria: Codex CLI executes the requested task and returns output, or user is guided to install/configure it.
Trigger Examples
Positive
- "Spin up a Codex agent to review PR #55"
- "Use Codex CLI to fix this bug"
- "Run codex on this issue"
- "Launch a codex agent"
- "codex exec: add error handling to the API"
Negative
- "Review this code" (generic — doesn't specify Codex CLI)
- "Explain how Codex works" (no execution needed)
- "Write a plan for this feature" (planning only)
Runtime Prompt
- Runtime prompt is defined directly in
../codex-cli.json.
Comments
Markdown supported