Plugin Structure for Codex

Overview

Codex plugins follow a standardized directory structure with automatic component discovery. Understanding this structure enables creating well-organized, maintainable plugins that integrate seamlessly with Codex.

Key concepts:

• Conventional directory layout for automatic discovery
• Manifest-driven configuration in .Codex-plugin/plugin.json
• Component-based organization (commands, agents, skills, hooks)
• Portable path references using ${CLAUDE_PLUGIN_ROOT}
• Explicit vs. auto-discovered component loading

Directory Structure

Every Codex plugin follows this organizational pattern: