codex

Delegates coding tasks to the OpenAI Codex CLI via terminal commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @openai/codex.

What problem does it solve? Offloading feature builds, refactors, and PR reviews to an autonomous coding agent requires knowing the right CLI flags, sandbox modes, and process management patterns. This Skill provides tested invocation patterns for running OpenAI Codex CLI from the Hermes terminal without hangs or sandbox failures. ## Core Features & Use Cases - One-Shot Execution: Run codex exec with PTY for tasks that complete and exit cleanly, including scratch work in temporary git repos. - Background Long Tasks: Launch Codex in background mode and monitor with process poll/log, sending input when Codex asks questions. - Parallel Workflows: Use git worktrees to fix multiple issues or review multiple PRs concurrently, then push branches and create PRs with gh. - Use Case: You need to fix issues #78 and #99 simultaneously. Create two git worktrees, launch a background Codex process in each with --sandbox workspace-write, monitor progress, then push both branches and open PRs. ## Quick Start Ask the agent to run codex exec with pty enabled inside your git repository to implement a feature such as adding a dark mode toggle to settings.

Frequently Asked Questions about codex

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

FAQPage Schema
How do I run OpenAI Codex CLI for a one-shot coding task?▼

Use codex exec with your prompt inside a git repository, for example codex exec 'Add dark mode toggle to settings'. Always set pty=true in the terminal call because Codex is an interactive terminal app that hangs without a PTY.

How to run Codex CLI in the background for long tasks?▼

Launch codex exec with background=true and pty=true, which returns a session_id. Monitor progress with process poll and log actions, send answers with submit if Codex asks a question, and kill the session if needed.

Why does Codex fail with bubblewrap permission errors in a gateway context?▼

The workspace-write sandbox can fail in service contexts like Telegram-driven sessions with errors such as 'setting up uid map: Permission denied'. Use --sandbox danger-full-access instead and rely on process boundaries, clean git status, 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 and initialize git first: cd $(mktemp -d) && git init && codex exec 'your task'.

How do I fix multiple GitHub issues in parallel with Codex?▼

Create a git worktree per issue with git worktree add, then launch a background Codex process in each worktree with --sandbox workspace-write. After completion, push each branch and create PRs with gh pr create, then remove the worktrees.

What authentication does the Codex CLI require?▼

Codex needs either an OPENAI_API_KEY environment variable or OAuth credentials from the Codex CLI login flow, typically stored under ~/.codex/auth.json. A missing OPENAI_API_KEY alone does not prove auth is absent if a valid OAuth session exists.