codex

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

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/brittb-dev/zerogravityclaw --skill codex-brittb-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex
Source: https://github.com/brittb-dev/zerogravityclaw/tree/main/src/hermes-core/skills/autonomous-ai-agents/codex
Command: npx skills add https://github.com/brittb-dev/zerogravityclaw --skill codex-brittb-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @openai/codex.

What problem does it solve? Delegating feature builds, refactors, and PR reviews to an autonomous coding agent requires knowing the right CLI flags, sandbox modes, and terminal settings; this Skill encodes those operational patterns so Codex runs correctly from an agent-driven terminal. ## Core Features & Use Cases - One-Shot Task Execution: Run codex exec with PTY enabled for single tasks that exit cleanly when done. - Background Long-Running Tasks: Launch Codex with --full-auto in the background and monitor progress with process poll/log/submit controls. - 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 have two open bug issues. Create two git worktrees, launch a Codex process in each with a fix prompt, monitor both sessions, then push the branches and open pull requests. ## Quick Start Ask the agent to run codex exec with your task prompt inside a git repository using pty=true, for example 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 OpenAI Codex CLI for a one-shot coding task?▼

Run codex exec with your prompt inside a git repository, using pty=true in the terminal call since Codex is an interactive terminal app. For scratch work without a repo, create a temp directory and run git init first.

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

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

Why does Codex CLI fail with bubblewrap permission errors?▼

Codex workspace-write sandboxing can fail in gateway or service contexts with errors like 'setting up uid map: Permission denied'. Use codex exec --sandbox danger-full-access instead and rely on process boundaries, clean git status, and diff review as the safety layer.

Does Codex CLI work outside a git repository?▼

No, Codex refuses to run outside a git repository. For scratch experiments, create a temporary directory with mktemp -d, run git init inside it, and then invoke codex exec with your prompt.

How do I review multiple pull requests in parallel with Codex?▼

Fetch all PR refs with git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*', then launch separate background codex exec sessions that diff each PR against main. Post the resulting reviews with gh pr comment.