codex-buddy

Codex plugins that wrap third-party coding and review CLIs so they can be driven from inside Codex.

This repository currently ships Codex-native opencode and claudecode plugins.

Before plugin development, this repo adopts the development workflow from ../claudecode-buddy. See AGENTS.md, docs/development-workflow.md, and docs/plans/.

Install

Clone this repository, then register it as a local Codex plugin marketplace:

git clone <this-repo-url> codex-buddy
cd codex-buddy
codex plugin marketplace add "$(pwd)"

Install the plugins you want:

codex plugin add opencode@codex-buddy
codex plugin add claudecode@codex-buddy

Restart Codex after installing or updating plugins.

Requirements

• Node.js 18.18 or newer for the companion runtimes.
• opencode on PATH, or set OPENCODE_BIN to an executable opencode binary.
• Claude Code on PATH, or set CLAUDECODE_BIN to an executable claude binary.

Run setup diagnostics from a repository where you want to use the wrappers:

node plugins/opencode/scripts/buddy.mjs setup
node plugins/claudecode/scripts/buddy.mjs setup

The setup commands print install or configuration guidance when a required external CLI is missing. The plugins do not install third-party CLIs automatically.

Usage

After installation, use the Codex slash commands:

/opencode:setup
/opencode:review --scope auto
/opencode:run --task "Implement the requested change" --yolo
/opencode:status
/opencode:result <job-id>
/opencode:cancel <job-id>

/claudecode:setup
/claudecode:review --scope auto
/claudecode:run --task "Implement the requested change" --yolo
/claudecode:status
/claudecode:result <job-id>
/claudecode:cancel <job-id>

The same behavior is available directly from the repo root:

node plugins/opencode/scripts/buddy.mjs review --scope auto
node plugins/claudecode/scripts/buddy.mjs review --scope auto

Runtime state is written under .codex-buddy/. Plugin-controlled temporary prompt and task files use .codex-buddy/<plugin>/tmp/, not routine system temporary directories.

opencode Plugin

The opencode plugin lives in plugins/opencode/.

• User guide: plugins/opencode/README.md
• Design spec: docs/specs/001-opencode-plugin.md
• Development workflow: docs/development-workflow.md

claudecode Plugin

The claudecode plugin lives in plugins/claudecode/.

• User guide: plugins/claudecode/README.md
• Design spec: docs/specs/002-claudecode-command-bridge.md