Codestin Search App

Install the right OmO edition, configure providers, run doctor, and try your first ulw.

OmO now ships in two editions from the same upstream product. Use Ultimate for the full OpenCode harness, or Light when you want the Codex CLI plugin bundle that LazyCodex installs.

Prerequisites

Item	Requirement
Harness	OpenCode for Ultimate, OpenAI Codex CLI for Light, or both.
Runtime	`bunx` for Ultimate. `npx lazycodex-ai install` for the Codex Light installer.
Providers	For Ultimate, whatever subset you have: Claude, OpenAI/ChatGPT, Gemini, GitHub Copilot, OpenCode Go/Zen, Kimi for Coding, Z.ai, or Vercel AI Gateway. Light does not ask provider-subscription questions.
OS	macOS ARM64/x64, Linux x64/ARM64 (incl. musl/Alpine), Windows x64.

Pick an Edition

You want	Run	What lands on disk
Ultimate for OpenCode	`bunx oh-my-openagent install`	OpenCode plugin registration, agent/model config, and provider auth prompts.
Light for Codex CLI	`npx lazycodex-ai install`	Managed `~/.codex/plugins/cache/sisyphuslabs/omo/`, Codex marketplace/plugin config, optional autonomous Codex permissions, component CLIs, and plugin-scoped MCPs.
Both	`bunx oh-my-openagent install --platform=both`	Both installer paths.

lazycodex-ai is the supported npm installer for the Codex Light edition. It is not the Codex marketplace name; Codex sees marketplace sisyphuslabs and plugin omo@sisyphuslabs.

Install

Ultimate: OpenCode

bunx oh-my-openagent install

The installer asks which model subscriptions you have, registers the OpenCode plugin, writes config, and prints auth hints for the providers you said yes to. The legacy package/CLI name oh-my-opencode still works during the rename transition, but new docs and config should prefer oh-my-openagent.

Ultimate: Non-Interactive Install

When an agent runs setup for you, pass flags directly:

bunx oh-my-openagent install --no-tui \
  --claude=yes \
  --openai=yes \
  --gemini=no \
  --copilot=no

Flag	Meaning
`--claude=no\|yes\|max20`	Claude subscription. `max20` for Claude Max 20x.
`--openai=no\|yes`	ChatGPT/OpenAI for GPT-backed agents like Oracle.
`--gemini=no\|yes`	Gemini.
`--copilot=no\|yes`	GitHub Copilot.
`--opencode-go=no\|yes`	OpenCode Go (GLM/Kimi/MiniMax).
`--opencode-zen=no\|yes`	`opencode/` model catalog.
`--zai-coding-plan=no\|yes`	Z.ai Coding Plan.
`--kimi-for-coding=no\|yes`	Kimi for Coding.
`--vercel-ai-gateway=no\|yes`	Vercel AI Gateway.
`--skip-auth`	Skip auth hints.

Provider selection is per-agent — OmO does not use one global priority.

Light: Codex CLI

npx lazycodex-ai install
# non-interactive recommended mode:
npx lazycodex-ai install --no-tui --codex-autonomous

--codex-autonomous lets the installer configure Codex for autonomous agent-style use: approval_policy = "never", sandbox_mode = "danger-full-access", and network_access = "enabled". Use --no-codex-autonomous if you want the installer to leave those permission settings alone.

Codex Marketplace Path

The marketplace path is experimental and additive; npx lazycodex-ai install remains the primary supported Light installer.

codex plugin marketplace add https://github.com/code-yeongyu/lazycodex
codex plugin add omo@sisyphuslabs

Relaunch Codex, review and approve the new hooks, then restart again after the background bootstrap notice completes.

Authenticate Providers

opencode auth login

This is an Ultimate/OpenCode step. For Gemini Antigravity OAuth, install the upstream opencode-antigravity-auth plugin. For GitHub Copilot, Z.ai, OpenCode Go, OpenCode Zen, and Kimi, the installer wires defaults from your provider flags.

Verify

opencode --version
bunx oh-my-openagent doctor
npx lazycodex-ai doctor

Use the first two commands for Ultimate and npx lazycodex-ai doctor for Light. doctor checks four groups:

Group	What it checks
System	OpenCode binary, version, plugin registration, legacy-name warnings.
Config	JSONC parsing, schema validation, file detection.
Tools	AST-Grep, LSP servers, GitHub CLI, MCP servers.
Models	Capability cache, normalization, agent/category overrides, fallback availability.

Use doctor --verbose when something looks wrong.

First Task

Inside an OpenCode session, type:

ulw fix the failing login flow and verify it in the browser

For precision-first work, plan before executing:

@plan refactor the auth module without behavior changes
/start-work

Need GPT-native deep work? Switch to Hephaestus from the agent selector and give him a goal, not a recipe.

Inside Codex after installing Light, use the LazyCodex/OmO components such as ultrawork, $ulw-loop, or the installed Codex plugin skills from the omo@sisyphuslabs marketplace bundle.

Telemetry

Anonymous active-install telemetry is on by default — at most one event per UTC day per machine, hashed installation identifier, no PostHog person profiles. Disable with either:

OMO_SEND_ANONYMOUS_TELEMETRY=0
OMO_DISABLE_POSTHOG=1
OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0
OMO_CODEX_DISABLE_POSTHOG=1

Getting Started