Overview
OCX is a configuration manager for OpenCode. It gives you portable profiles, curated component registries, and SHA-256 verified integrity — so your AI agent never runs code you haven’t reviewed.Why OCX?
- Profiles — Work in any repository with your own configuration, without modifying the project.
- Registries — Install profiles and components from curated, versioned registries.
- Auditable — Every component is SHA-256 verified. You own the code.
Philosophy
OCX follows the ShadCN model: components are copied into your project (.opencode/), not hidden in node_modules. You own the code — customize freely.
Like Cargo, OCX resolves dependencies and verifies integrity. Every component is SHA-256 verified at install time and on every subsequent update.
Your AI agent never runs code you haven’t reviewed.
How It Works
- Initialize your global configuration with
ocx init --global. - Install a profile from a registry or create one from scratch.
- Launch OpenCode with
ocx oc -p <name>— your profile controls what OpenCode sees throughexclude/includepatterns.
Next Steps
- Install OCX to get started on macOS, Linux, or Windows.
- Follow the Quick Start to configure and launch your first profile.
- Explore Profiles for a deep dive into configuration isolation.
- Browse the CLI Reference for the full command documentation.