Support Codex Plugin format when agents path is added to plugin spec

[shinpr]

Context

Codex CLI v0.116.0 introduced a Plugin system that packages skills, MCP servers, and apps into a single distributable unit via .codex-plugin/plugin.json.

However, the current plugin manifest only supports three path fields:

• skills
• mcpServers
• apps

There is no agents path for subagent TOML definitions (.codex/agents/*.toml), which is a core part of codex-workflows (23 agent definitions).

What to do

When the Codex plugin spec adds support for an agents path in plugin.json:

1. Add .codex-plugin/plugin.json manifest to the repo
2. Restructure the directory layout to match plugin conventions
3. Migrate the install/update CLI (bin/cli.js) to work as a plugin, or deprecate it in favor of Codex's native plugin install
4. Update README with plugin-based installation instructions

References

• Plugin manifest schema: codex-rs/core/src/plugins/manifest.rs in openai/codex
• Plugin types: codex-rs/app-server-protocol/schema/typescript/v2/Plugin*.ts
• Current PluginManifestPaths fields: skills, mcp_servers, apps (no agents)

Status

Blocked — waiting for upstream Codex plugin spec to support agent definitions.