codex-headless

Delegate coding, review, and documentation tasks to the OpenAI Codex CLI in headless mode.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/StefanMaksimek/dev-challenge-2026 --skill codex-headless
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-headless
Source: https://github.com/StefanMaksimek/dev-challenge-2026/tree/main/.claude/skills/codex-headless
Command: npx skills add https://github.com/StefanMaksimek/dev-challenge-2026 --skill codex-headless

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates delegating coding, documentation, and web research tasks to the OpenAI Codex CLI in headless mode, reducing manual prompt engineering and speeding up project workflows.

Core Features & Use Cases

  • Headless Codex delegation: Run coding tasks, reviews, and documentation generation without interactive prompts.
  • Selective workspace access: Enforces sandboxed repository access (--sandbox workspace-write) and uses a ChatGPT Plus/Pro subscription (no API keys).
  • Web research integration: Perform targeted web searches with --search and incorporate findings into outputs.

Quick Start

codex exec --full-auto "Create a README.md for this project"

Frequently Asked Questions about codex-headless

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

FAQPage Schema
How do I run OpenAI Codex CLI in headless mode to automate coding tasks?

To run Codex CLI in headless mode, execute tasks using the `--full-auto` flag. This delegates coding, documentation, and web research workflows to OpenAI Codex without requiring interactive prompts.

Can I use my ChatGPT Plus subscription to automate code generation without API keys?

Yes, you can automate code generation using your ChatGPT Plus or Pro subscription without API keys. The headless Codex execution leverages your existing subscription for coding and review tasks.

How do I perform web research and incorporate findings into CLI coding outputs?

Perform targeted web research during coding tasks by appending the `--search` flag to your Codex CLI execution. This integrates search findings directly into your generated code and documentation outputs.

Does Codex CLI headless mode restrict file system access for automated workflows?

Yes, headless Codex execution enforces restricted workspace access using the `--sandbox workspace-write` flag. This ensures automated coding workflows operate safely within a designated repository boundary.

Why does the Codex CLI disallow the --yolo flag during headless task automation?

The `--yolo` flag is disallowed to enforce strict safety and output controls during headless execution. This prevents unrestricted system modifications, ensuring automated coding tasks remain sandboxed and secure.

What is the best way to delegate code reviews and documentation generation to Codex?

The best way to delegate code reviews and documentation generation is using the `codex exec` command in headless mode. This automates the workflow safely within a restricted workspace sandbox.