codex

---

description: Delegate coding tasks to OpenAI Codex CLI agent. Use for building features, refactoring, PR reviews, and batch issue fixing. Requires the codex CLI and a git repository. version: 1.0.0 license: MIT metadata: catalog: tags: - Coding-Agent - Codex - OpenAI - Code-Review - Refactoring related_skills: - claude-code ---

Kheish Compatibility

This skill is repo-local and stays inactive until explicitly activated.

When the original instructions refer to legacy tool names, use these Kheish mappings:

• terminal => bash
• web_extract => web_fetch, plus web_search when discovery is needed
• search_files => grep_search and glob_search
• browser_* tools require a browser-capable surfaced tool or MCP; if none is available, use the closest available surface and say so explicitly

When the instructions mention local helper files, resolve them from ${KHEISH_SKILL_DIR}.

Codex CLI

Delegate coding tasks to Codex via the Kheish terminal. Codex is OpenAI's autonomous coding agent CLI.

Prerequisites

• Codex installed: npm install -g @openai/codex
• OpenAI API key configured
• Must run inside a git repository — Codex refuses to run outside one
• Use pty=true in terminal calls — Codex is an interactive terminal app

One-Shot Tasks

terminal(command="codex exec 'Add dark mode toggle to settings'", workdir="~/project", pty=true)

For scratch work (Codex needs a git repo):

terminal(command="cd $(mktemp -d) && git init && codex exec 'Build a snake game in Python'", pty=true)

Background Mode (Long Tasks)

# Start in background
bash(command="codex exec --full-auto 'Refactor the auth module'", workdir="~/project", background=true)
# Returns one task id

# Monitor progress
task_list()
task_output(task_id="<id>")

# Kill if needed
task_stop(task_id="<id>")

Key Flags

Flag	Effect
exec "prompt"	One-shot execution, exits when done
--full-auto	Sandboxed but auto-approves file changes in workspace
--yolo	No sandbox, no approvals (fastest, most dangerous)