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

# Oh-My-OpenAgent Setup

> Set up oh-my-openagent with OCX profiles for a portable AI coding environment

## Overview

Set up [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) with OCX profiles for a fully portable AI coding environment using OpenCode Zen models.

**Prerequisites**: [OCX installed](/docs/getting-started/installation) and [global profiles initialized](/docs/profiles/overview)

## Step 1: Install the omo Profile

```bash theme={null}
# One-command install with ephemeral registry (not saved)
ocx profile add omo --source kit/omo --from https://ocx-kit.kdco.dev --global

# Or add registry first, then install
ocx registry add https://ocx-kit.kdco.dev --name kit --global
ocx profile add omo --source kit/omo --global
```

## Step 2: Launch

```bash theme={null}
ocx oc -p omo
```

The profile comes pre-configured with [OpenCode Zen](https://opencode.ai/docs/zen/) models.

## What's Included

The `omo` profile includes:

| File                    | Purpose                                                    |
| ----------------------- | ---------------------------------------------------------- |
| `opencode.jsonc`        | Default models + oh-my-openagent plugin                    |
| `oh-my-openagent.jsonc` | Agent and category configurations with OpenCode Zen models |
| `ocx.jsonc`             | Profile isolation settings                                 |

**Pre-configured models:**

* **DeepSeek V4 Flash Free** — primary model for OMO agents and deep categories
* **Nemotron 3 Super Free** — small model, quick tasks, writing, and search helpers
* **Big Pickle** — fallback model for orchestration and compatibility

The profile includes all current upstream OMO agents: Sisyphus, Hephaestus, Prometheus, Oracle, Librarian, Explore, Multimodal-Looker, Metis, Momus, Atlas, and Sisyphus-Junior.

## Customize Models

Edit your profile's oh-my-openagent config:

```bash theme={null}
# View available models
opencode models

# Edit the config
$EDITOR ~/.config/opencode/profiles/omo/oh-my-openagent.jsonc
```

See the [oh-my-openagent configuration docs](https://github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/reference/configuration.md) for all options.

## Tips

**Set as default profile:**

```bash theme={null}
export OCX_PROFILE=omo  # Add to ~/.zshrc or ~/.bashrc
```

**Clone for variations:**

```bash theme={null}
ocx profile add work --clone omo --global
```

**For untrusted repos**, see [Profile Security](/docs/profiles/security).

## Next Steps

* [KDCO Workspace Guide](/docs/guides/kdco-workspace) — Full multi-agent workspace setup.
* [Profiles Overview](/docs/profiles/overview) — Understanding profile concepts.
* [ocx profile](/docs/cli/profile) — Manage profiles from the CLI.

## See Also

* [oh-my-openagent documentation](https://github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/reference/configuration.md) — Manual setup and advanced configuration.