Allow plugins to bundle and register custom agents
Open 💬 2 comments Opened Apr 22, 2026 by madebymlai
💡 Likely answer: A maintainer (github-actions[bot], contributor)
responded on this thread — see the highlighted reply below.
What variant of Codex are you using?
CLI
What feature would you like to see?
Allow plugins to declare and register custom agents alongside skills, apps, and MCP servers.
The plugin spec currently supports three bundle types: skills, apps, and MCP servers. There is no way for a plugin to declare custom agents (~/.codex/agents/*.toml).
Plugins that rely on agent orchestration must work around this with a separate install step that converts agent definitions into skill files in ~/.codex/skills/.
On plugin install, Codex would register the bundled agents in ~/.codex/agents/ (or equivalent) so they're available for subagent spawning without consuming the skills budget.
Additional information
no info.
2 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Is there a plan to support this issue?