Codex-Compound
A Codex-first derivative of Compound Engineering that preserves the ce:* workflow surface while making AGENTS.md, CONTINUITY.md, .beads/, and handoff/beads.jsonl first-class.
Claude Code Install
/plugin marketplace add apollostreetcompany/codex-compound
/plugin install compound-engineering
Cursor Install
/add-plugin compound-engineering
OpenCode, Codex, Droid, Pi, Gemini, Copilot, Kiro, Windsurf, OpenClaw & Qwen (experimental) Install
This repo includes a Bun/TypeScript CLI that converts Claude Code plugins to OpenCode, Codex, Factory Droid, Pi, Gemini CLI, GitHub Copilot, Kiro CLI, Windsurf, OpenClaw, and Qwen Code.
Until the standalone npm package is published, run these commands from a checkout with bun run src/index.ts .... The examples below show the intended installed command name.
# convert the compound-engineering plugin into OpenCode format
bunx codex-compound install compound-engineering --to opencode
# convert to Codex format
bunx codex-compound install compound-engineering --to codex
# convert to Factory Droid format
bunx codex-compound install compound-engineering --to droid
# convert to Pi format
bunx codex-compound install compound-engineering --to pi
# convert to Gemini CLI format
bunx codex-compound install compound-engineering --to gemini
# convert to GitHub Copilot format
bunx codex-compound install compound-engineering --to copilot
# convert to Kiro CLI format
bunx codex-compound install compound-engineering --to kiro
# convert to OpenClaw format
bunx codex-compound install compound-engineering --to openclaw
# convert to Windsurf format (global scope by default)
bunx codex-compound install compound-engineering --to windsurf
# convert to Windsurf workspace scope
bunx codex-compound install compound-engineering --to windsurf --scope workspace
# convert to Qwen Code format
bunx codex-compound install compound-engineering --to qwen
# auto-detect installed tools and install to all
bunx codex-compound install compound-engineering --to all
Local Development
When developing and testing local changes to the plugin:
Claude Code — add a shell alias so your local copy loads alongside your normal plugins:
# add to ~/.zshrc or ~/.bashrc
alias claude-dev-ce='claude --plugin-dir ~/code/codex-compound/plugins/compound-engineering'
One-liner to append it:
echo "alias claude-dev-ce='claude --plugin-dir ~/code/codex-compound/plugins/compound-engineering'" >> ~/.zshrc
Then run claude-dev-ce instead of claude to test your changes. Your production install stays untouched.
Codex — point the install command at your local path:
bun run src/index.ts install ./plugins/compound-engineering --to codex
Other targets — same pattern, swap the target:
bun run src/index.ts install ./plugins/compound-engineering --to opencode
Output format details per target
| Target | Output path | Notes |
|---|
opencode | ~/.config/opencode/ | Commands as .md files; opencode.json MCP config deep-merged; backups made before overwriting |
codex | ~/.codex/prompts + ~/.codex/skills | Claude commands become prompt + skill pairs; canonical ce:* workflow skills also get prompt wrappers; deprecated workflows:* aliases are omitted |
droid | ~/.factory/ | Tool names mapped (Bash→Execute, Write→Create); namespace prefixes stripped |
pi | ~/.pi/agent/ | Prompts, skills, extensions, and mcporter.json for MCPorter interoperability |
gemini | .gemini/ | Skills from agents; commands as .toml; namespaced commands become directories (workflows:plan → commands/workflows/plan.toml) |
copilot | .github/ | Agents as .agent.md with Copilot frontmatter; MCP env vars prefixed with COPILOT_MCP_ |
kiro | .kiro/ | Agents as JSON configs + prompt .md files; only stdio MCP servers supported |
openclaw | ~/.openclaw/extensions/<plugin>/ | Entry-point TypeScript skill file; openclaw-extension.json for MCP servers |
windsurf | ~/.codeium/windsurf/ (global) or .windsurf/ (workspace) | Agents become skills; commands become flat workflows; mcp_config.json merged |
qwen | ~/.qwen/extensions/<plugin>/ | Agents as .yaml; env vars with placeholders extracted as settings; colon separator for nested commands |
All provider targets are experimental and may change as the formats evolve.
Sync Personal Config