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:
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:
This installs the oh-my-openagent 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:
Or set a default profile via environment variable:

​
Verify Your Setup

List your installed profiles:
You should see:
Inspect the profile configuration:

​
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

​
Next Steps