everyinc--compound-engineering-plugin/docs/development.md

Development

The repository's build and validation commands, and how to load a local checkout into the harnesses that have a documented local-load path. For contribution process — what to do before opening a PR — see CONTRIBUTING.md.

---

Repository commands

bun install
bun run test              # full suite, --parallel, exactly as CI runs it
bun run release:validate  # plugin/marketplace consistency
bun run plugin:validate   # Claude marketplace + plugin schema (needs `claude` on PATH)

From your local checkout

For active development, load this checkout directly in the harness you want to test. The harnesses below are the ones with a verified local-load path.

Compound Engineering supports more hosts than are listed here — Grok Build CLI, GitHub Copilot, Factory Droid, and Qwen Code among them. Those install from the marketplace (install options) but have no documented way to point at an unreleased checkout, so test changes for them against a released version, or add a path here once you have verified one.

Claude Code

claude --plugin-dir "$PWD"

Cursor Agent CLI

cursor-agent --plugin-dir "$PWD"

Codex

For the normal production-like plugin installation, use the Codex App or Codex CLI instructions in the README. The workflow below is only for contributors who need Codex to load unreleased files from an exact checkout or linked worktree.

Advanced: test this exact checkout in Codex

Select the current worktree as the active Codex development source:

bun run codex:dev -- local

This creates one collection symlink at $CODEX_HOME/skills/compound-engineering-local (default ~/.codex/skills/compound-engineering-local) pointing to this worktree's skills/ directory. It removes installed Compound Engineering plugin variants through the Codex CLI so a cached marketplace plugin cannot shadow or duplicate the local skills. It does not copy skills, change the checkout, pull Git, or touch unrelated entries under $CODEX_HOME/skills.

The link exposes exactly what is in the selected worktree, including modified and untracked skills. Ordinary edits therefore need no reinstall, and current Codex versions detect direct skill changes automatically. Start a new session after switching between local and remote installation modes; if an ordinary skill edit does not appear, restart Codex.

Use these commands to inspect and switch modes:

bun run codex:dev -- status
bun run codex:dev -- refresh
bun run codex:dev -- remote
bun run codex:dev -- remove

• status reports local, remote, mixed, drifted, or absent state plus the linked checkout, worktree kind, branch, commit SHA, and dirty counts.
• refresh is an idempotent alias for local; use it to reconcile accidental plugin installs. The live link already reflects file changes.
• remote refreshes the official Git marketplace, installs and verifies compound-engineering@compound-engineering-plugin, then removes the local link. Use it to simulate the released user experience.
• remove removes Compound Engineering plugin variants and the managed link, leaving the checkout and unrelated user skills intact.

The script derives the repository path, so it works from checkouts in any location, including paths with spaces. It inherits the active CODEX_HOME; set CODEX_HOME on the command when testing an isolated profile. Run every mode against the same CODEX_HOME you use to launch Codex.

Do not use codex plugin marketplace add "$PWD" for live local development. It installs a cached copy of this checkout, so later edits are not reflected until the plugin is installed again; a matching manifest version also does not prove the cache matches the worktree. The codex:dev workflow instead keeps Codex linked to the current skill files.

Kimi Code CLI

Inside Kimi Code CLI:

/plugins install /path/to/compound-engineering-plugin

To test the local marketplace catalog instead, pass the catalog path:

/plugins marketplace /path/to/compound-engineering-plugin/.kimi-plugin/marketplace.json

Cline

/path/to/compound-engineering-plugin/.cline/scripts/install-skills.sh --global

Enable Settings -> Features -> Enable Skills in the Cline extension, then start a new task.

Devin CLI

devin plugins install /path/to/compound-engineering-plugin

Local installs are linked to the checkout rather than copied, so skill edits apply on the next Devin session without reinstalling.

OpenCode

{
  "plugin": ["/path/to/compound-engineering-plugin"]
}

Restart OpenCode after changing opencode.json.

Pi

pi -e "$PWD"

oh-my-pi (omp)

omp plugin link "$PWD"

Antigravity CLI (agy)

agy plugin install "$PWD"
agy plugin validate "$PWD"

Or install the bundled .agy/ entry point:

agy plugin install "$PWD/.agy"

See .agy/INSTALL.md for remote install and pinning examples.