<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> OCX addresses the challenge of managing disparate OpenCode configurations and extensions across diverse projects and environments. It targets developers seeking a portable, consistent, and secure setup for their coding tools, enabling them to leverage their preferred configurations anywhere without project modification.

How It Works

The core mechanism employs isolated "profiles" to control what OpenCode perceives, preventing conflicts and ensuring project-specific settings. Components, including npm plugins and MCP servers, are sourced from curated registries and are copied directly into the user's project (à la ShadCN), fostering code ownership and customization. Dependency resolution, version pinning, and SHA-256 integrity verification (akin to Cargo) ensure auditable and reproducible builds, enhancing security and reliability.

Quick Start & Requirements

Installation is straightforward: macOS/Linux users can use curl -fsSL https://ocx.kdco.dev/install.sh | sh, while cross-platform npm installation is available via npm install -g ocx. Supported platforms include macOS (x64, Apple Silicon), Linux (x64, arm64), and Windows (x64). Initial setup involves ocx init --global for profile initialization, followed by ocx profile add <name> to create specific work environments. Launching OpenCode with a profile is done via ocx oc -p <profile_name> within a project directory.

Highlighted Details

• Profile Management: Enables granular control over OpenCode's environment via include/exclude patterns for each profile.
• Component Architecture: Facilitates adding components from registries, with code copied locally to .opencode/ for direct modification.
• Security & Auditing: Guarantees component integrity through SHA-256 verification and version pinning, with ocx diff for pre-update change review.
• Registry Scaffolding: Provides tools to quickly create new component registries with integrated one-click deployment options for major cloud platforms.

Maintenance & Community

The provided README does not detail specific maintenance contributors, sponsorships, partnerships, or community channels (e.g., Discord, Slack).

Licensing & Compatibility

The project is released under the MIT license, which is permissive and generally compatible with commercial use and integration into closed-source projects.

Limitations & Caveats

By default, profiles may include project AGENTS.md files; users must explicitly uncomment **/AGENTS.md in the profile's exclude list when working with untrusted repositories. OCX is a third-party tool, unaffiliated with the official OpenCode project.