Skip to content

Codex support details

Rules and skills are native, prompts become skills, and aix still treats MCP as global-only.

Codex is strongest when AGENTS.md and Agent Skills are the destination format you want.

Start on the full support matrix when you need to compare every editor at once. Use this page when you want the exact terms, support details, and project/user targets for Codex.

Related aix concepts: rules , prompts , mcp , skills , hooks .

Editor-specific notes

  • Codex prompts are converted into skills because aix no longer writes native prompt files for Codex.
  • Codex upstream supports project-scoped MCP config, but aix still manages the global file today.

Feature details

How to read the statuses

Support key

Editor support

  • Supported The editor exposes that feature at that scope.
  • No support The editor does not expose that feature at that scope.

aix support

  • Native aix writes the editor's own format.
  • Adapter aix keeps the feature through an adapter or alternate representation.
  • No support aix does not write that feature for the destination today.

Use the Project scope and User scope rows to see where config lands at each level.

Rules Learn the concept

Section-managed markdown in project and directory-specific AGENTS.md files.

Codex calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md at the project root and selected subdirectories
User
Editor Supported aix Native
Path ~/.codex/AGENTS.md
  • Activation modes collapse into plain markdown headings and directory placement.

Prompts Learn the concept

Prompt-to-skill conversion during install.

Codex calls this Skills
aix support Adapter
Project
Editor Supported aix Adapter
Path .agents/skills/prompt-{name}/
aix: Prompts are installed as instruction-only Agent Skills.
User
Editor Supported aix Adapter
Path ~/.codex/skills/prompt-{name}/
aix: User-scoped prompts are also converted to skills.

MCP Learn the concept

TOML MCP configuration currently managed as global-only by aix.

Codex calls this MCP servers
aix support Native
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix does not yet write Codex project MCP config.
User
Editor Supported aix Native
Path ~/.codex/config.toml
  • Upstream Codex also supports .codex/config.toml in trusted projects.

Skills Learn the concept

Symlinked native skill directories backed by .aix/skills/.

Codex calls this Skills
aix support Native
Project
Editor Supported aix Native
Path .agents/skills/{name}/
User
Editor Supported aix Native
Path ~/.codex/skills/{name}/

Agents

Codex does not document custom subagent files that aix can write safely.

Codex calls this Agents
aix support No support
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Codex.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: aix reports configured agents as unsupported for Codex.

Hooks Learn the concept

Hooks are not supported.

Codex calls this Hooks
aix support No support
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Codex does not support lifecycle hooks in aix.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Codex does not support lifecycle hooks in aix.

AGENTS.md

Codex natively layers AGENTS.md files through the directory tree.

Codex calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md in the repository tree
User
Editor Supported aix Native
Path ~/.codex/AGENTS.md

.agents/skills

Codex natively discovers Agent Skills directories.

Codex calls this .agents/skills
aix support Native
Project
Editor Supported aix Native
Path .agents/skills/{name}/
User
Editor Supported aix Native
Path ~/.agents/skills/{name}/

Related guides