Codex CLI

The Codex adapter writes an inspectable Codex plugin bundle. Instructions use AGENTS.md, skills use the Agent Skills layout, and reusable agents become TOML definitions.

Native output

.codex-plugin/plugin.json
AGENTS.md
skills/<name>/SKILL.md
agents/<name>.toml
prompts/<name>.md
hooks/hooks.json
.mcp.json

Translation details

• Portable commands become Codex prompt files.
• Agent tool allowlists are omitted because Codex agent definitions do not expose a matching field.
• Only command-type hook handlers execute; prompt and agent handlers are reported and skipped.
• Portable tools run through a generated MCP stdio server.

Build this target

pnpm soubi build ./my-plugin --harness codex

Codex hooks require the corresponding Codex feature flag. The generated files remain valid when hooks are disabled; the harness simply does not execute them.