@opencode-compat/ocp

User-facing OCP umbrella: one install + ocp setup writes Layer A install-tree overrides (and default Option B provider entry shims) so published OpenCode plugins resolve @opencode-ai/plugin / @opencode-ai/sdk through the compatibility facades.

End-user install (MiMo / Kilo + npm): see the monorepo INSTALL.md.

# from this monorepo (developers)
bun run build
bun packages/ocp/bin/ocp.ts setup --host mimo --dry-run
bun packages/ocp/bin/ocp.ts setup --dir /path/to/host/plugin/cache

setup default --mode auto uses local file: facade paths from this checkout when present; outside the monorepo use --mode npm (see INSTALL.md).

The default provider-shim action applies the active host's LanguageModel compatibility policy and adopts tool argument keys from each call's advertised schema. Exact schema keys win; only unique case/separator-insensitive matches are renamed. Runtime identity wins for host-specific policy; a setup-time install-tree host hint covers isolated provider workers that hide host process markers.

Commands

| Command | Role | |---------|------| | ocp setup | Default. Write @opencode-ai/* → facade overrides into the host plugin install tree | | ocp overrides | Print override JSON only | | ocp doctor | Host detect + capability summary | | ocp matrix | OCP §10 fixtures (checkout-rooted) | | ocp migrate-zcode | Companion migrator (not OCP ABI) |

setup options: --dir, --host, --mode auto|npm|file, --version, --dry-run, --deep / --no-deep, --reify / --no-reify (default auto-reify when a patched tree already has node_modules), --provider-shim / --no-provider-shim.

Bridge packages (profile, facade-*, adapter, host-promise-v2, cli, …) ship as transitive dependencies / implementation detail.

License: MPL-2.0

See INSTALL.md, the monorepo README, OCP 0.1, and host notes under docs/hosts/.