Quick Start

Quick Start

Get Oh My OpenAgent running in under 5 minutes. Two installation methods — let an agent do it, or do it yourself.

Prerequisites

• OpenCode installed and configured
• At least one LLM subscription with API access (Claude, ChatGPT, Kimi, GLM, etc.)

Installation

Method A: Agent-Assisted (Recommended)

Copy this prompt and paste it to your LLM agent (Claude Code, AmpCode, Cursor, etc.):

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

The agent will:

• Download and install the oh-my-opencode package
• Register the plugin in your opencode.json
• Set up default configuration

Method B: Manual Installation

Follow the Installation Guide step by step.

Note

The published package and binary name is oh-my-opencode. Inside opencode.json, the plugin entry is oh-my-openagent. Legacy oh-my-opencode entries still load with a deprecation warning.

First Run: ultrawork

After installation, try ultrawork immediately:

ultrawork

Or the shorter alias:

ulw

One word activates every agent. They don’t stop until the task is done.

Tip

Try something real: ultrawork: refactor the auth module or just ulw: fix all lint warnings. The agents handle decomposition, delegation, and execution automatically.

Recommended Subscriptions

Oh My OpenAgent works well with these subscriptions (not affiliated, personal recommendation):

Subscription	Price	Notes
ChatGPT	$20/mo	Solid multi-agent experience
Kimi Code	$0.99/mo	Excellent value, limited time pricing
GLM Coding Plan	$10/mo	Good for GLM model access

If you have pay-per-token access, Kimi and Gemini models are very affordable.

Verify Installation

Run the built-in doctor command:

bunx oh-my-opencode doctor

This checks:

• Plugin registration in opencode.json
• Configuration file validity
• Model availability and API keys
• Environment setup

Context Injection

Oh My OpenAgent automatically injects context into every session:

• AGENTS.md — Hierarchical project context (see /init-deep)
• README.md — Project overview
• Conditional rules — Auto-activated based on file type, agent, or task phase

Telemetry

Anonymous telemetry is enabled by default via PostHog. It uses a hashed installation identifier — never your raw hostname.

To disable:

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# or
export OMO_DISABLE_POSTHOG=1

See Privacy Policy for details.

Uninstallation

To remove Oh My OpenAgent:

1. Remove the plugin entry from opencode.json:

# Using jq
jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
  ~/.config/opencode/opencode.json > /tmp/oc.json && \
  mv /tmp/oc.json ~/.config/opencode/opencode.json

2. Remove config files (optional):

rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
  ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json
rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
  .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json

3. Verify removal: opencode --version — plugin should no longer appear.

Next Steps

• Agent System — Understand how agents collaborate
• Tools — Explore Hashline, LSP, MCPs
• Features — Ralph Loop, Todo Enforcer, and more