How do I install the Codex Docs skill?

Run npx skillmds@latest add wenerme/codex-docs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codex Docs safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codex Docs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codex Docs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codex Docs?

wenerme (@wenerme) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codex Docs by wenerme — Agent Skill

Name: Codex Docs
Author: wenerme

Codex Docs

USE THIS SKILL WHEN working with OpenAI Codex CLI, Codex App, or Codex Cloud: configuration (config.toml), approval modes, sandbox, execution policy, skills, AGENTS.md, slash commands, non-interactive/exec mode, multi-agent, MCP servers, GitHub Action, IDE extension, enterprise setup, or Codex SDK. Triggers on: codex, codex exec, codex cli, AGENTS.md (OpenAI), config.toml codex, codex skills, codex sandbox, codex rules.

wenerme b8c801b 164 files · 1.4 MB Updated Sep 17, 2026

File contents

OpenAI Codex Documentation

Reference for OpenAI Codex — AI coding agent available as CLI, desktop app, cloud, and IDE extension.

Docs | GitHub | Changelog

CRITICAL: grep references/ for detailed docs before answering.

Quick Start

# Install
npm install -g @openai/codex

# Interactive mode
codex "Explain this codebase"

# Non-interactive (CI/scripts)
codex exec "Fix all lint errors"
codex exec --json "List all TODO comments"

Key Concepts

Concept	Description
Approval modes	Auto, Read-only, Full Access — control what Codex can do
Sandbox	Filesystem/network isolation for safe execution
Rules	Starlark-based execution policies (`.codex/rules/`)
Skills	Task-specific capabilities (`.agents/skills/`)
AGENTS.md	Custom system prompts per repo/directory
config.toml	User/project config (`~/.codex/config.toml`)
MCP	Model Context Protocol server integration
Multi-agent	Spawn sub-agents for parallel work

Key Topics

CLI

references/cli/features.md — Interactive mode, sessions, model selection
references/cli/reference.md — CLI command reference
references/cli/slash-commands.md — /model, /review, /plan, /permissions, etc.
references/noninteractive.md — codex exec for CI/scripts

Configuration

references/config-basic.md — config.toml basics
references/config-advanced.md — Advanced configuration
references/config-reference.md — Full config reference
references/config-sample.md — Sample config file

Security & Sandbox

references/concepts/sandboxing.md — Sandbox modes
references/rules.md — Execution policy rules (Starlark)
references/agent-approvals-security.md — Approval system
references/security/ — Security setup, threat model, FAQ

Customization

references/skills.md — Agent Skills system
references/guides/agents-md.md — AGENTS.md custom prompts
references/custom-prompts.md — Custom prompts (deprecated, use skills)
references/prompting.md — Prompting best practices

App & IDE

references/app/ — Codex desktop app (features, automations, worktrees)
references/ide/ — VS Code extension (features, commands, settings)
references/cloud/ — Codex Cloud environments

Integrations

references/mcp.md — MCP server configuration
references/integrations/github.md — GitHub integration
references/integrations/linear.md — Linear integration
references/integrations/slack.md — Slack integration
references/github-action.md — GitHub Action for CI

Enterprise

references/enterprise/admin-setup.md — Admin setup
references/enterprise/managed-configuration.md — Managed config
references/enterprise/governance.md — Governance policies

References

references/ — 64 doc files from developers.openai.com/codex
references/cli/ — CLI features, reference, slash commands
references/app/ — Desktop app docs
references/ide/ — IDE extension docs
references/security/ — Security & sandbox docs
references/enterprise/ — Enterprise administration

---name: codex-docsdescription: USE THIS SKILL WHEN working with OpenAI Codex CLI, Codex App, or Codex Cloud: configuration (config.toml), approval modes, sandbox, execution policy, skills, AGENTS.md, slash commands, non-interactive/exec mode, multi-agent, MCP servers, GitHub Action, IDE extension, enterprise setup, or Codex SDK. Triggers on: codex, codex exec, codex cli, AGENTS.md (OpenAI), config.toml codex, codex skills, codex sandbox, codex rules.---# OpenAI Codex DocumentationReference for [OpenAI Codex](https://developers.openai.com/codex/overview) — AI coding agent available as CLI, desktop app, cloud, and IDE extension.- [Docs](https://developers.openai.com/codex/overview) | [GitHub](https://github.com/openai/codex) | [Changelog](https://developers.openai.com/codex/changelog)CRITICAL: grep `references/` for detailed docs before answering.## Quick Start```bash# Installnpm install -g @openai/codex# Interactive modecodex "Explain this codebase"# Non-interactive (CI/scripts)codex exec "Fix all lint errors"codex exec --json "List all TODO comments"```## Key Concepts| Concept | Description ||---------|-------------|| **Approval modes** | Auto, Read-only, Full Access — control what Codex can do || **Sandbox** | Filesystem/network isolation for safe execution || **Rules** | Starlark-based execution policies (`.codex/rules/`) || **Skills** | Task-specific capabilities (`.agents/skills/`) || **AGENTS.md** | Custom system prompts per repo/directory || **config.toml** | User/project config (`~/.codex/config.toml`) || **MCP** | Model Context Protocol server integration || **Multi-agent** | Spawn sub-agents for parallel work |## Key Topics### CLI- `references/cli/features.md` — Interactive mode, sessions, model selection- `references/cli/reference.md` — CLI command reference- `references/cli/slash-commands.md` — `/model`, `/review`, `/plan`, `/permissions`, etc.- `references/noninteractive.md` — `codex exec` for CI/scripts### Configuration- `references/config-basic.md` — config.toml basics- `references/config-advanced.md` — Advanced configuration- `references/config-reference.md` — Full config reference- `references/config-sample.md` — Sample config file### Security & Sandbox- `references/concepts/sandboxing.md` — Sandbox modes- `references/rules.md` — Execution policy rules (Starlark)- `references/agent-approvals-security.md` — Approval system- `references/security/` — Security setup, threat model, FAQ### Customization- `references/skills.md` — Agent Skills system- `references/guides/agents-md.md` — AGENTS.md custom prompts- `references/custom-prompts.md` — Custom prompts (deprecated, use skills)- `references/prompting.md` — Prompting best practices### App & IDE- `references/app/` — Codex desktop app (features, automations, worktrees)- `references/ide/` — VS Code extension (features, commands, settings)- `references/cloud/` — Codex Cloud environments### Integrations- `references/mcp.md` — MCP server configuration- `references/integrations/github.md` — GitHub integration- `references/integrations/linear.md` — Linear integration- `references/integrations/slack.md` — Slack integration- `references/github-action.md` — GitHub Action for CI### Enterprise- `references/enterprise/admin-setup.md` — Admin setup- `references/enterprise/managed-configuration.md` — Managed config- `references/enterprise/governance.md` — Governance policies## References- `references/` — 64 doc files from developers.openai.com/codex- `references/cli/` — CLI features, reference, slash commands- `references/app/` — Desktop app docs- `references/ide/` — IDE extension docs- `references/security/` — Security & sandbox docs- `references/enterprise/` — Enterprise administration

Frequently asked questions