---
agents_txt_version: "0.2"
format: markdown
schema:
  sections: "## heading = section name"
  subsections: "### heading = subsection grouping"
  pages: "- [title](path) {type}"
  page_types: [overview, tutorial, guide, reference, use-case, tool-reference, sdk-guide, best-practices]
  navigation: "See ## Navigation Guide section"
---

# Codex Documentation

- **URL**: https://developers.openai.com
- **Standard**: agents.txt v0.2 (AgentNav PoC)
- **Total Pages**: 71
- **Last Updated**: 2026-03-31

## Site Overview

| # | Section | Pages | Base Path |
|---|---------|-------|-----------|
| 1 | Getting Started | 4 | /codex/ |
| 2 | Concepts | 7 | /codex/ |
| 3 | Using Codex — App | 10 | /codex/app/ |
| 4 | Using Codex — IDE Extension | 5 | /codex/ide/ |
| 5 | Using Codex — CLI | 4 | /codex/cli/ |
| 6 | Using Codex — Web | 3 | /codex/cloud/ |
| 7 | Integrations | 3 | /codex/integrations/ |
| 8 | Codex Security | 4 | /codex/security/ |
| 9 | Configuration | 14 | /codex/ |
| 10 | Administration | 6 | /codex/ |
| 11 | Automation | 5 | /codex/ |
| 12 | Learn | 3 | /codex/ |
| 13 | Community | 1 | /codex/ |
| 14 | Releases | 2 | /codex/ |

---

## Getting Started (4 pages)

- [Quickstart](/codex/quickstart) {tutorial}
- [Explore](/codex/explore) {use-case}
- [Codex Pricing](/codex/pricing) {reference}
- [Codex](/codex/overview) {overview}

## Concepts (7 pages)

- [Prompting](/codex/prompting) {guide}
- [Customization](/codex/concepts/customization) {guide}
- [Sandboxing](/codex/concepts/sandboxing) {guide}
- [Subagents](/codex/concepts/subagents) {guide}
- [Workflows](/codex/workflows) {guide}
- [Codex Models](/codex/models) {reference}
- [Cyber Safety](/codex/concepts/cyber-safety) {guide}

## Using Codex — App (10 pages)

- [Codex app](/codex/app) {overview}
- [Codex app features](/codex/app/features) {tool-reference}
- [Codex app settings](/codex/app/settings) {reference}
- [Review](/codex/app/review) {guide}
- [Automations](/codex/app/automations) {guide}
- [Worktrees](/codex/app/worktrees) {guide}
- [Local environments](/codex/app/local-environments) {guide}
- [Codex app commands](/codex/app/commands) {reference}
- [Windows](/codex/app/windows) {guide}
- [Troubleshooting](/codex/app/troubleshooting) {guide}

## Using Codex — IDE Extension (5 pages)

- [Codex IDE extension](/codex/ide) {overview}
- [Codex IDE extension features](/codex/ide/features) {tool-reference}
- [Codex IDE extension settings](/codex/ide/settings) {reference}
- [Codex IDE extension commands](/codex/ide/commands) {reference}
- [Codex IDE extension slash commands](/codex/ide/slash-commands) {reference}

## Using Codex — CLI (4 pages)

- [Codex CLI](/codex/cli) {overview}
- [Codex CLI features](/codex/cli/features) {tool-reference}
- [Command line options](/codex/cli/reference) {reference}
- [Slash commands in Codex CLI](/codex/cli/slash-commands) {reference}

## Using Codex — Web (3 pages)

- [Codex web](/codex/cloud) {overview}
- [Cloud environments](/codex/cloud/environments) {guide}
- [Agent internet access](/codex/cloud/internet-access) {guide}

## Integrations (3 pages)

- [Use Codex in GitHub](/codex/integrations/github) {guide}
- [Use Codex in Slack](/codex/integrations/slack) {guide}
- [Use Codex in Linear](/codex/integrations/linear) {guide}

## Codex Security (4 pages)

- [Codex Security](/codex/security) {overview}
- [Codex Security setup](/codex/security/setup) {tutorial}
- [Improving the threat model](/codex/security/threat-model) {guide}
- [FAQ](/codex/security/faq) {reference}

## Configuration (14 pages)

### Config File

- [Config basics](/codex/config-basic) {guide}
- [Advanced Configuration](/codex/config-advanced) {guide}
- [Configuration Reference](/codex/config-reference) {reference}
- [Sample Configuration](/codex/config-sample) {reference}

### Settings

- [Speed](/codex/speed) {guide}
- [Rules](/codex/rules) {guide}
- [Custom instructions with AGENTS.md](/codex/guides/agents-md) {guide}
- [Model Context Protocol](/codex/mcp) {guide}
- [Agent Skills](/codex/skills) {guide}
- [Subagents](/codex/subagents) {guide}
- [Custom Prompts](/codex/custom-prompts) {best-practices}
- [Hooks](/codex/hooks) {guide}
- [Plugins](/codex/plugins) {guide}
- [Build plugins](/codex/plugins/build) {guide}

## Administration (6 pages)

- [Authentication](/codex/auth) {guide}
- [Agent approvals & security](/codex/agent-approvals-security) {guide}

### Enterprise

- [Admin Setup](/codex/enterprise/admin-setup) {tutorial}
- [Governance](/codex/enterprise/governance) {guide}
- [Managed configuration](/codex/enterprise/managed-configuration) {guide}

### Platform

- [Windows](/codex/windows) {guide}

## Automation (5 pages)

- [Non-interactive mode](/codex/noninteractive) {guide}
- [Codex SDK](/codex/sdk) {sdk-guide}
- [Codex App Server](/codex/app-server) {guide}
- [Use Codex with the Agents SDK](/codex/guides/agents-sdk) {sdk-guide}
- [Codex GitHub Action](/codex/github-action) {guide}

## Learn (3 pages)

- [Videos](/codex/videos) {reference}
- [Building an AI-Native Engineering Team](/codex/guides/build-ai-native-engineering-team) {guide}
- [Best Practices](/codex/learn/best-practices) {reference}

### External Resources

- [Building Frontend UIs with Codex and Figma](/blog/building-frontend-uis-with-codex-and-figma) — Blog
- [Run Long Horizon Tasks with Codex](/blog/run-long-horizon-tasks-with-codex) — Blog
- [Codex Prompting Guide](/cookbook/examples/gpt-5/codex_prompting_guide) — Cookbook
- [Modernizing Your Codebase with Codex](/cookbook/examples/codex/code_modernization) — Cookbook

## Community (1 page)

- [Codex for Open Source](/codex/community/codex-for-oss) {overview}

## Releases (2 pages)

- [Feature Maturity](/codex/feature-maturity) {reference}
- [Open Source](/codex/open-source) {reference}

---

## Navigation Guide

### Quick Navigation

| Intent | Best Section | Key Pages |
|--------|-------------|-----------|
| Getting started | Getting Started | Quickstart, Explore |
| How to prompt | Concepts | Prompting |
| Desktop app usage | App | Codex app, Codex app features, Codex app commands |
| VS Code integration | IDE Extension | Codex IDE extension, Codex IDE extension features |
| Terminal usage | CLI | Codex CLI, Codex CLI features, Command line options |
| Cloud/web usage | Web | Codex web, Cloud environments |
| Connect to GitHub/Slack | Integrations | Use Codex in GitHub, Use Codex in Slack, Use Codex in Linear |
| Security setup | Codex Security | Codex Security, Codex Security setup |
| Configure Codex | Configuration | Config basics, Configuration Reference |
| Enterprise setup | Administration | Admin Setup, Governance |
| CI/CD automation | Automation | Non-interactive mode, Codex GitHub Action |
| SDK integration | Automation | Codex SDK, Use Codex with the Agents SDK |
| Release notes | Releases | Codex changelog |

### Search Priority

1. Getting Started — overview, quickstart
2. Concepts — prompting, workflows, models
3. Configuration — config, rules, agents-md, mcp, skills
4. App / CLI — platform-specific features
5. Automation — SDK, non-interactive, github-action