codex

Delegate coding tasks to the OpenAI Codex CLI from Hermes terminal sessions.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill codex-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/autonomous-ai-agents/codex
Command: npx skills add https://github.com/Chia1104/agent-air --skill codex-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running the interactive Codex CLI from an agent environment is error-prone: it hangs without a PTY, refuses to run outside git repositories, and its sandboxing can break in gateway contexts. This Skill provides tested invocation patterns for delegating coding work to Codex reliably. ## Core Features & Use Cases - One-Shot and Background Execution: Run codex exec for quick tasks or launch long-running refactors in background sessions monitored via the process tool. - Parallel Workflows: Use git worktrees to fix multiple issues or review multiple PRs concurrently with separate Codex processes. - Sandbox Guidance: Choose the right sandbox flag (workspace-write vs danger-full-access) depending on whether you run interactively or from a Hermes gateway. - Use Case: Ask the agent to fix two GitHub issues at once; it creates worktrees, launches Codex in each, monitors progress, pushes branches, and opens PRs with gh. ## Quick Start Ask the agent to use Codex to implement a feature or fix an issue in your current git repository, for example: run Codex to add a dark mode toggle to the settings page.

Frequently Asked Questions about codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Codex CLI for one-shot coding tasks?▼

Use `codex exec "prompt"` inside a git repository with pty=true in the terminal call. The command runs the task and exits cleanly when done, making it suitable for single features or fixes.

How to fix multiple GitHub issues in parallel with Codex?▼

Create a separate git worktree per issue, then launch `codex exec` in each worktree with background=true. Monitor sessions with the process tool, push branches, and open PRs with `gh pr create`.

Why does Codex CLI hang when run from an agent?▼

Codex is an interactive terminal application and hangs without a pseudo-terminal. Always set pty=true in terminal calls so Codex receives a proper TTY session.

Why does Codex sandbox fail with permission denied errors?▼

In Hermes gateway or service contexts, bubblewrap user-namespace setup can fail with uid map or loopback errors. Use `--sandbox danger-full-access` there and rely on process boundaries, clean git state, and diff review for safety.

Does Codex CLI work outside a git repository?▼

No, Codex refuses to run outside a git repository. For scratch work, create a temporary directory with `mktemp -d`, run `git init`, and then invoke Codex inside it.