Skip to main content

​
Overview

Work in any repository without modifying it. Your configuration, their code. Time to complete: 5 minutes Prerequisites: OCX installed

​
Step 1: Initialize Global Configuration

Set up the global profile directory: 
ocx init --global
This creates ~/.config/opencode/ with the base configuration structure.

​
Step 2: Install a Profile from a Registry

Install a pre-configured profile using a registry reference: 
ocx profile add omo --source kit/omo --from https://ocx-kit.kdco.dev --global
This installs the oh-my-opencode profile from the OCX Kit registry. The --from flag uses an ephemeral registry reference (not saved to your config).
Visual Profile Builder: Prefer a UI? TweakOC helps you build and configure profiles visually, then outputs an ocx profile add command you can run.

​
Step 3: Launch OpenCode with Your Profile

Navigate to any repository and launch OpenCode: 
cd ~/oss/some-project
ocx oc -p omo
Or set a default profile via environment variable: 
export OCX_PROFILE=omo
ocx oc

​
Verify Your Setup

List your installed profiles: 
ocx profile list --global
You should see: 
Global profiles:
  omo
Inspect the profile configuration: 
ocx profile show omo --global

​
What Profiles Control

Profiles control what OpenCode sees through exclude/include patterns. Each profile has isolated registries for security. OpenCode configuration merges safely between profile and local settings.
An empty exclude list includes all project instruction files. The default profile template ships a secure exclude list. For trusted repositories, edit your profile to loosen the template’s exclude list. See Lock Down Recipe.

​
Common Commands

CommandDescription
ocx profile add <name> --source <registry/profile> --from <url> --globalInstall a profile from a registry
ocx profile add <name> --clone <existing> --globalClone an existing profile
ocx oc -p <name>Launch OpenCode with a profile
ocx profile list --globalList your profiles
ocx config edit --globalEdit your global configuration

​
Next Steps