- Switch profiles. Keep separate configurations for work, personal projects, and review.
- Own your files. Install agents, skills, commands, and profile recipes from a registry, then edit them directly.
- Review updates. Preview file changes, protect local edits, and verify installations against recorded hashes.
OCX 3 is the OpenCode V2 preview. It requires OpenCode 2.0.3 or newer within major version 2. The frozen OCX 2.0.15 line supports OpenCode V1. The legacy documentation remains available in the navigation.
Get started
After setting up the preview, create a profile and launch:~/.config/ocx/profiles/, or $XDG_CONFIG_HOME/ocx/profiles/. Add your native OpenCode configuration, instructions, agents, and skills there. OCX selects the directory; OpenCode loads its contents.
Installation
Set up the development preview and select your OpenCode V2 executable.
Quick start
Create, customize, and switch between your first profiles.
File registries
Install editable components and manage their updates.
Moving from V1
Preview an import while keeping your existing setup intact.
What OCX manages
There is no OCX runtime plugin or launch-time configuration overlay. Profiles share OpenCode’s native credential and session storage; they are configuration choices, not separate accounts. See profile behavior for project discovery and instruction loading.
Explore the reference
- Configuration explains each OCX file, source scope, and selection rule.
- CLI reference covers commands, options, examples, and exit codes.
- Create a registry walks through publishing your own components.
- Troubleshooting covers version checks, file conflicts, and recovery.