Skip to content
Productivity
Skill

/codex-cli

Run OpenAI Codex CLI as a background agent — detect, install, configure, and execute tasks via codex exec.

BOOST
@cowork-oscowork-os@cowork-os
From plugin
cowork-os
544157 skills

Claude Code

$ npx -y skills add CoWork-OS/CoWork-OS --skill codex-cli --agent claude-code

SKILL.md

codex-cli.SKILL.md
name: codex-cli
description: "Run OpenAI Codex CLI as a background agent — detect, install, configure, and execute tasks via codex exec."
version: "1.0.0"
metadata:
  author: CoWork OS Contributors <info@coworkosapp.com>

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`.
Read more
Read it on GitHub ↗
Stats
JavaScriptReactNext.jsHTMLBashDockerLinuxGitHubPlaywrightAnthropicOpenAISlack
542
Stars
100
Forks
Active
Maintenance
TypeScript
Language
MIT
License
Last commit
Created

Repo: CoWork-OS/CoWork-OS

In this plugin
157 skills
See everything inside
@cowork-os
Ships withcowork-os

Rent the model. Own everything else. Free, open-source AI app for real work.

544157 skills
Get the whole plugin

Stars on GitHub

Momentum

stars in total
544
Star history of CoWork-OS/CoWork-OS on GitHub, a chart by star-history.com
See what's trending this week

Other skills on cowork-os.

attack-path-analysis

attack-path-analysis

Use when Codex is already in the attack-path-analysis phase of a security scan or the user explicitly asks to trace a security…

cowork-os
@cowork-os@cowork-osInstall Skill
deep-security-scan

deep-security-scan

Use when the user asks for a deep, exhaustive, multi-pass, or variance-reducing repository-wide Codex Security scan. Run repeated…

cowork-os
@cowork-os@cowork-osInstall Skill
finding-discovery

finding-discovery

Use when Codex is already in the finding-discovery phase of a security scan or the user explicitly asks to discover candidate…

cowork-os
@cowork-os@cowork-osInstall Skill
fix-finding

fix-finding

Use when the user explicitly asks to fix and verify a validated or plausible security finding. Do not use as the primary trigger…

cowork-os
@cowork-os@cowork-osInstall Skill
security-diff-scan

security-diff-scan

Use when the user asks for a security review of a pull request, commit, branch diff, working-tree patch, or other Git-backed…

cowork-os
@cowork-os@cowork-osInstall Skill
See all 157 skills in cowork-os

More skills from other plugins.

i-have-adhd

i-have-adhd

Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…

i-have-adhd3w60k
@ayghri@ayghriInstall Skill
ab-test-analysis

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop…

pm-skills6d28k
@phuryn@phurynInstall Skill
distilly

distilly

Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…

titanwings-distilly4w26k
@titanwings@titanwingsInstall Skill

Questions about codex-cli.

Which coding agents can use codex-cli?
codex-cli installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.