---
name: cowork-os/codex-cli
source: https://app.decimal.ai/s/cowork-os-codex-cli@1/SKILL.md
source_sha256: 75141e1a211f
---

# codex-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`.