Agent skill · software engineering · nousresearch
codex
Delegate coding to OpenAI Codex CLI (features, PRs).
Why this skill is useful
Adds executable commands for automating coding tasks with Codex, including PR reviews and batch issue fixing.
What it needs
Requires @openai/codex installed locally. Requires openai account access. About 3k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
Codex CLI Delegate coding tasks to Codex via the Hermes terminal. Codex is OpenAI's autonomous coding agent CLI. When to use Building features Refactoring PR reviews Batch issue fixing Requires the codex CLI and a git repository. Prerequisites Codex installed: npm install -g @openai/codex OpenAI auth configured: either OPENAIAPIKEY or Codex OAuth credentials from the Codex CLI login flow Must run inside a git repository — Codex refuses to run outside one Use pty=true in terminal calls — Codex is an interactive terminal app For Hermes itself, model.provider: openai-codex uses Hermes-managed Codex OAuth from ~/.hermes/auth.json after hermes auth add openai-codex. For the standalone Codex CLI, a valid CLI OAuth session may live under ~/.codex/auth.json; do not treat a missing OPENAIAPIKEY alone as proof that Codex auth is missing. One-Shot Tasks For scratch work (Codex needs a git repo): Background Mode (Long Tasks) Key Flags Flag Effect ------ -------- exec "prompt" One-shot execution, exits when done --sandbox workspace-write (-s) Sandboxed but auto-approves file changes in the workspace (the recommended auto-build mode) --dangerously-bypass-approvals-and-sandbox No sandbox, no approvals (fastest, most dangerous; --yolo still works as a hidden alias) --sandbox danger-full-access No Codex sandbox; useful when the host service context breaks bubblewrap Deprecated: --full-auto still works but the live CLI warns to use --sandbox workspace-write instead. Hermes Gateway Caveat When invoking the Codex CLI from a Hermes gateway/service context (for example, Telegram-driven agent sessions), Codex workspace-write sandboxing may fail even when the same command works in the user's interactive shell. A typical symptom is bubblewrap/user-namespace errors such as setting up uid map: Permission denied or loopback: Failed RTMNEWADDR: Operation not permitted. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/codex