DevBoy tools

    Codex Plugin

    Install devboy as a Codex plugin. Same architecture as the Claude Code plugin — agent-driven bootstrap, no bundled binary, MCP server registration, namespaced skills.

    Install

    Codex CLI reads the same Claude-style marketplace.json that the Claude Code plugin uses (one of the four marketplace sources documented in Codex plugin docs), so add this repo as a marketplace and install:

    codex plugin marketplace add meteora-pro/devboy-tools
codex plugin install devboy@meteora-devboy

    OpenAI's official Plugin Directory does not yet accept self-serve community submissions ("coming soon" per the official docs at the time of writing); the per-repo marketplace path above is the supported way to ship today.

    What happens next

    The bundled setup skill triggers on first use and:

    1. Detects plugin context — $CODEX_PLUGIN_DATA is set, picks --agent codex.
    2. Installs devboy (npm → fallback to GitHub Release tarball in ${CODEX_PLUGIN_DATA}/bin/, verified via the per-asset .sha256 sibling; releases are not code-signed, the SHA file is the integrity check).
    3. Runs devboy onboard --agent codex --yes.
    4. Runs devboy doctor.
    5. On failure, hands off to repair.

    After install, restart the Codex session so the MCP server entry binds against the new binary.

    What the plugin ships

    ComponentPath inside the plugin
    Manifestplugins/codex/.codex-plugin/plugin.json
    Skills (24)plugins/codex/skills symlink → ../claude/skills
    MCP serverplugins/codex/.mcp.json
    Binary locatorplugins/codex/bin/devboy-shim.sh symlink → ../../claude/bin/devboy-shim.sh

    Skill names match the source one-to-one (no rename). Namespaced as /devboy:setup, /devboy:review-mr, …, /devboy:analyze-usage.

    Compared to the Claude Code plugin

    The two plugins share /crates/devboy-skills/skills/ as their source of truth and produce identical user-visible skill surface. Differences are mechanical:

    Claude CodeCodex
    Manifest dir.claude-plugin/.codex-plugin/
    Plugin data envCLAUDE_PLUGIN_DATACODEX_PLUGIN_DATA
    Plugin root envCLAUDE_PLUGIN_ROOTCODEX_PLUGIN_ROOT
    Subagent formatMarkdownTOML (none today)
    Marketplacemeteora-pro/devboy-tools (this repo, via .claude-plugin/marketplace.json)same .claude-plugin/marketplace.json — Codex CLI also reads it (see Codex plugin sources)

    devboy onboard dedups against ~/.codex/settings.json#enabledPlugins the same way it does for Claude.

    Troubleshooting

    Same playbook as Claude Code:

    • After setup finishes, restart the Codex session for the MCP server to bind.
    • If npm install -g fails, the GitHub Release fallback in ${CODEX_PLUGIN_DATA}/bin/ activates automatically.
    • For everything else, run /devboy:repair.

    See also