codex

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @openai/codex.

What problem does it solve? Offloading feature development, refactoring, and PR reviews to an autonomous coding agent requires knowing the correct Codex CLI invocation patterns, sandbox flags, and process management, which are easy to get wrong from a gateway or service context. ## Core Features & Use Cases - One-Shot Task Execution: Run codex exec with PTY for single tasks like adding features or building scratch projects in temporary git repositories. - Background Long-Running Tasks: Launch Codex with background=true and monitor progress using process poll, log, submit, and kill actions. - Parallel Workflows: Use git worktrees to fix multiple issues or review multiple PRs concurrently with separate Codex processes. - Use Case: You receive two bug reports overnight. Create two git worktrees, launch a Codex process in each with --yolo exec, monitor both with the process tool, then push branches and open PRs with gh pr create. ## Quick Start Ask the agent to run Codex in one-shot mode on your repository, for example by requesting it to add a dark mode toggle to the settings page using codex exec with pty enabled.

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 terminal call with pty=true and a workdir pointing to a git repository. Codex executes the task and exits cleanly when finished, making it suitable for single features or fixes.

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 input with submit if Codex asks a question, and kill the session if needed.

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

Codex workspace-write sandboxing can fail from service contexts with bubblewrap errors like uid map permission denied. Use codex exec --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 with mktemp -d, run git init inside it, and then invoke codex exec with your task prompt.

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

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