Build and install plugins in Codex

Codex now supports plugins: installable bundles that package skills, app integrations, and MCP server configuration for reusable workflows.

Plugins are available in the Codex app, CLI, and IDE extensions.

You can install curated plugins from the plugin directory, or scaffold a local plugin with @plugin-creator and test it with workspace-scoped or home-scoped marketplaces.

Learn more in the plugins documentation.

Plugin structure

Every plugin is a folder with a required .codex-plugin/plugin.json manifest and optional supporting files:

my-plugin/
  .codex-plugin/
    plugin.json   # Required: plugin manifest
  skills/         # Optional: packaged skills
  .app.json       # Optional: app or connector mappings
  .mcp.json       # Optional: MCP server configuration
  assets/         # Optional: icons, logos, screenshots

Install plugins per-user or per-repo

You can install plugins for just yourself with ~/.agents/plugins/marketplace.json and ~/.codex/plugins/, or for everyone on a project with .agents/plugins/marketplace.json and a repo-local plugin directory such as ./plugins/.

Curated plugins and local development

Codex surfaces curated public plugins in the plugin directory. Codex also ships with the built-in @plugin-creator skill to help you scaffold a plugin, add a local marketplace entry, and test it before sharing it with teammates.