> ## Documentation Index
> Fetch the complete documentation index at: https://ocx.kdco.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Set up OCX and launch OpenCode with your own profile in under five minutes

## Overview

Work in any repository without modifying it. Your configuration, their code.

**Time to complete**: 5 minutes
**Prerequisites**: [OCX installed](/docs/getting-started/installation)

## Step 1: Initialize Global Configuration

Set up the global profile directory:

```bash theme={null}
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:

```bash theme={null}
ocx profile add omo --source kit/omo --from https://ocx-kit.kdco.dev --global
```

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).

<Tip>
  **Visual Profile Builder:** Prefer a UI? [TweakOC](https://tweakoc.com) helps you build and configure profiles visually, then outputs an `ocx profile add` command you can run.
</Tip>

## Step 3: Launch OpenCode with Your Profile

Navigate to any repository and launch OpenCode:

```bash theme={null}
cd ~/oss/some-project
ocx oc -p omo
```

Or set a default profile via environment variable:

```bash theme={null}
export OCX_PROFILE=omo
ocx oc
```

## Verify Your Setup

List your installed profiles:

```bash theme={null}
ocx profile list --global
```

You should see:

```text theme={null}
Global profiles:
  omo
```

Inspect the profile configuration:

```bash theme={null}
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.

<Warning>
  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](/docs/profiles/security).
</Warning>

## Common Commands

| Command                                                                    | Description                       |
| -------------------------------------------------------------------------- | --------------------------------- |
| `ocx profile add <name> --source <registry/profile> --from <url> --global` | Install a profile from a registry |
| `ocx profile add <name> --clone <existing> --global`                       | Clone an existing profile         |
| `ocx oc -p <name>`                                                         | Launch OpenCode with a profile    |
| `ocx profile list --global`                                                | List your profiles                |
| `ocx config edit --global`                                                 | Edit your global configuration    |

## Next Steps

* [Profiles Overview](/docs/profiles/overview) — Deep dive into profile configuration and isolation.
* [Profile Security](/docs/profiles/security) — Lock down recipes for untrusted repositories.
* [CLI Reference](/docs/cli/commands) — Full command documentation.