codex

# Codex CLI Delegate coding tasks to [Codex](https://github.com/openai/codex) via the Hermes 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 with PTY terminal(command="codex exec --full-auto 'Refactor the auth module'", workdir="~/project", background=true, pty=true) # Returns session_id # Monitor progress process(action="poll", session_id="<id>") process(action="log", session_id="<id>") # Send input if Codex asks a question process(action="submit", session_id="<id>", data="yes") # Kill if needed process(action="kill", session_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) | ## PR Reviews Clone to a temp directory for safe review: ``` terminal(command="REVIEW=$(mktemp -d) && ...