[!NOTE] OmO for Codex is here: try LazyCodex

We loved Anthropic models enough to get blocked. Now we are backing Codex. If you are an OmO fan but the setup felt like too much, use LazyCodex. OmO for Codex has shipped:

npx lazycodex-ai install

Learn more at lazycodex.ai.

[!NOTE] Multi-Harness Agent OS Refactor in Progress

We are restructuring the codebase to support multiple agent harnesses (OpenCode, Codex, Pi, and others). If you are interested in contributing, please read the ROADMAP first. PRs related to roadmap work should use the ROADMAP label.

[!TIP] Building in Public

The maintainer builds and maintains oh-my-openagent in real-time with Jobdori, an AI assistant running on a heavily customized fork of OpenClaw. Every feature, every fix, every issue triage — live in our Discord.

→ Watch it happen in #building-in-public

[!NOTE]

OmO is maintained by Jobdori, the AI assistant shown above. Meet your own Jobdori — Dori. <br />Join the waitlist here.

[!TIP] Be with us!

<img alt="Discord link" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />	Join our Discord community to connect with contributors and fellow oh-my-openagent users.
<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />	Updates for oh-my-openagent used to be posted on my X account. <br /> Since it was mistakenly suspended, @justsisyphus now posts updates on my behalf.
<img alt="GitHub Follow" src="https://img.shields.io/github/followers/code-yeongyu?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />	Follow @code-yeongyu on GitHub for more projects.

<!-- <CENTERED SECTION FOR GITHUB DISPLAY> --> <div align="center">

<a href="https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent"><img src="./.github/assets/omo-icon-light.svg" alt="OmO" width="200" /></a>

</div>

This is oh-my-openagent, running Team Mode. With Kimi K3 and GPT-5.6 Sol.

Anthropic blocked OpenCode because of us. Yes, this is true. They want you locked in. Claude Code is a nice prison, but it's still a prison.

You don't need to pay $200 for 2 hours of work. The future isn't picking one winner; it's orchestrating them all. Models get cheaper every month. Smarter every month. No single provider will dominate. We're building for that open market, not their walled gardens.

<div align="center">

English | 한국어 | 日本語 | 简体中文

</div> <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->

Reviews

"It made me cancel my Cursor subscription. Unbelievable things are happening in the open source community." - Arthur Guiot

"If Claude Code does in 7 days what a human does in 3 months, Sisyphus does it in 1 hour. It just works until the task is done. It is a discipline agent." <br/>- B, Quant Researcher

"Knocked out 8000 eslint warnings with Oh My Opencode, just in a day" <br/>- Jacob Ferrari

"I converted a 45k line tauri app into a SaaS web app overnight using Ohmyopencode and ralph loop. Started with interview me prompt, asked it for ratings and recommendations on the questions. It was amazing to watch it work and to wake up this morning to a mostly working website!" - James Hargis

"use oh-my-opencode, you will never go back" <br/>- d0t3ch

"I haven't really been able to articulate exactly what makes it so great yet, but the development experience has reached a completely different dimension." - 苔硯:こけすずり

"Experimenting with open code, oh my opencode and supermemory this weekend to build some minecraft/souls-like abomination." "Asking it to add crouch animations while I go take my post-lunch walk. [Video]" - MagiMetal

"You guys should pull this into core and recruit him. Seriously. It's really, really, really good." <br/>- Henning Kilset

"Hire @yeon_gyu_kim if you can convince him, this dude has revolutionized opencode." <br/>- mysticaltech

"Oh My OpenCode Is Actually Insane" - YouTube - Darren Builds AI

---

Oh My OpenAgent

You're juggling Claude Code, Codex, and random OSS models. Configuring workflows. Debugging agents.

We did the work. Tested everything. Kept what actually shipped.

Install oh-my-openagent. Type ultrawork. Done.

Installation

oh-my-openagent ships in three editions of the same product: two plugins that load into a host you already run, plus one standalone edition.

• Ultimate Edition (omo for OpenCode) — full omo. 11 agents, 54+ lifecycle hooks, 5 built-in MCPs, all slash commands, Team Mode, /goal, ultrawork — everything. Hashline edits are opt-in (hashline_edit: true).
• Light Edition (omo for Codex CLI) — the portable components that fit Codex's plugin system: rules, comment-checker, git-bash, lsp, ultrawork, ulw-loop, ulw-execute-continuation, and telemetry at the core, plus teammode and supporting components (bootstrap, lcx, and more), plugin-scoped MCPs for grep_app, context7, git_bash, and lsp, and the shared ast-grep skill. It installs Codex agent TOMLs into ~/.codex/agents/. No OpenCode team_* tools — Codex CLI's own spawn/collaboration surface does that work.
• Senpi Edition (standalone, beta) — the native omo command with the OMO extension built in. It installs from omo-ai@beta rather than loading into OpenCode or Codex.

Pick the edition(s) you want.

TL;DR

You want	Run	What lands on disk
Ultimate (OpenCode)	bunx oh-my-openagent install (TUI walks you through it)	Plugin registered in opencode.json + agent/model config + provider auth prompts
Light (Codex CLI)	npx lazycodex-ai install	~/.codex/plugins/cache/sisyphuslabs/omo/ + local Codex marketplace cache + ~/.codex/config.toml marketplace/plugin/agent blocks + optional autonomous permissions + component CLIs in ~/.local/bin
Both	bunx oh-my-openagent install --platform=both	Both of the above
Senpi edition (beta)	npm i -g omo-ai@beta, then omo	The omo command: pinned senpi release with the OMO extension built in. Beta channel only; a bare npm i -g omo-ai fails by design. See the install guide.

lazycodex-ai defaults to the Codex Light installer and runs through Node/npm. --platform on the shared omo-agent-toolkit CLI still defaults to opencode (Ultimate).

Which edition should I pick?

• Already use OpenCode, or want the most-tested path? Choose Ultimate: bunx oh-my-openagent install.
• Already use Codex CLI? Choose Light: npx lazycodex-ai install.
• Want one command without installing a host first? Choose Senpi/native (beta): npm i -g omo-ai@beta.

Ultimate and Light are plugins that load into a host you already run. Senpi is standalone: it ships a pinned Senpi engine with OMO built in.

For Senpi, the @beta tag is required; bare npm i -g omo-ai fails by design. Do not install plain omo from npm: it is an unrelated package by a different author.

For Humans

Strongly recommended: let an LLM agent install this for you. The Ultimate edition setup involves subscription detection, model selection across 11 agents, and per-provider authentication — humans fat-finger these. An LLM agent reads the full guide and walks every step correctly.

Paste this prompt into Claude Code, AmpCode, Cursor, or any agent:

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

If you only want the Light edition (Codex CLI), the installer asks whether to configure Codex for autonomous full-permissions mode. You can run it yourself in one line:

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

For the Light edition, Bun is not required. Use npx lazycodex-ai install from a Node/npm environment. Global installation is not officially supported; the installer writes the Codex plugin into ~/.codex/.

For LLM Agents

Fetch the full guide and follow it step by step:

curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

The guide covers: platform selection, the subscription interview, provider authentication (Anthropic / Gemini / Copilot / Z.ai / OpenCode Zen), the agent-to-model matching matrix, modes (ultrawork, team, hyperplan), slash commands, the Light edition's Codex components, Team Mode, and uninstall. Don't summarize it; read it end to end.

Note on package and command names

The published npm package and CLI binary are still named oh-my-opencode (dual-published as oh-my-openagent during the rename transition). Inside opencode.json, the compatibility layer prefers the plugin entry oh-my-openagent, while legacy oh-my-opencode entries still load with a warning. Runtime config is ~/.omo/omo.jsonc plus walked project .omo/omo.jsonc. Legacy oh-my-openagent.json[c] / oh-my-opencode.json[c] files are imported once by the migration engine and are not read afterward.

The recommended bunx/npx invocation is oh-my-openagent install (or the original oh-my-opencode install). Once installed, the short command is omo-agent-toolkit. The omo bin was removed from these packages in this major release; the name now belongs to the senpi-native edition, installed with npm i -g omo-ai@beta (beta channel only). Do not use bunx omo or npx omo: omo on npm is a different, unrelated package by a different author, and those commands resolve to it. The senpi edition's package name is omo-ai. lazycodex-ai is a single-purpose Node/npm installer package: npx lazycodex-ai install routes directly to the Codex Light installer. It is not the Codex marketplace name (the marketplace repository is code-yeongyu/lazycodex). Codex sees marketplace sisyphuslabs and plugin omo, enabled as omo@sisyphuslabs.

Telemetry

Anonymous telemetry is enabled by default to track active installations (DAU/WAU/MAU). For both products, a single event is sent at most once per UTC day per machine using a SHA256-hashed installation identifier (never the raw hostname), and PostHog person profiles are not created. The main plugin emits omo_daily_active from plugin load (plugin_loaded) and CLI run (run_started) sources; the Codex CLI Light edition emits omo_codex_daily_active from two sources (install_completed and session_start).

Opt out per product:

• Main plugin: set "telemetry": false in oh-my-openagent config, OMO_DISABLE_POSTHOG=1, or OMO_SEND_ANONYMOUS_TELEMETRY=0
• Codex CLI Light edition: OMO_CODEX_DISABLE_POSTHOG=1 or OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0 (the global flags also disable Codex)

See Privacy Policy and Terms of Service.

---

Skip This README

We're past the era of reading docs. Just paste this into your agent:

Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/README.md

ROADMAP

We are restructuring the codebase to support multiple agent harnesses (OpenCode, Codex, Pi, Claude Code, and others). The most urgent work is the package layering refactor: separating pure TypeScript core logic, MCP servers, skills, and adapter shims into distinct layers so the same logic can be reused across harnesses without duplication.

If you want to contribute, read the ROADMAP first. PRs related to this refactor should use the ROADMAP label so we can track them.

Highlights

🪄 ultrawork

You're actually reading this? Wild.

Install. Type ultrawork (or ulw). Done.

Everything below, every feature, every optimization: you don't need to know any of it. It just works.

Even with only the following subscriptions, ultrawork works well (this project is not affiliated; these are personal recommendations):

• ChatGPT Subscription ($20)
• Kimi Code Subscription ($19)
• GLM Coding Plan ($10)
• If you're eligible for pay-per-token, using Kimi and Gemini models won't cost much.

	Feature	Edition	What it does
🤖	Discipline Agents	Ultimate	Sisyphus orchestrates Hephaestus, Oracle, Librarian, Explore. A full AI dev team in parallel.
🧩	Codex CLI Light Edition	Light	Portable OMO components (rules, comment-checker, git-bash, LSP, ultrawork, ulw-loop, ulw-execute continuation, telemetry, teammode, and more) running inside OpenAI Codex CLI. Install via npx lazycodex-ai install.
👥	Team Mode (v4.0, opt-in)	Ultimate	Lead agent + up to 8 parallel members, real-time tmux visualization, dedicated team_* tools. Powers hyperplan (5 hostile critics) and security-research (3 hunters + 2 PoC engineers). Docs →
⚡	ultrawork / ulw	Both	One word. Every agent activates. Doesn't stop until done.
🚪	IntentGate	Ultimate	Analyzes true user intent before classifying or acting. No more literal misinterpretations. (Light edition only recognises the ultrawork/ulw keyword.)
🔗	Hash-Anchored Edit Tool	Ultimate	Hashline (LINE#ID) edit/read tagging. Opt-in: set hashline_edit: true in ~/.omo/omo.jsonc. Zero stale-line errors. Inspired by oh-my-pi. The Harness Problem →
🛠️	LSP integration	Both	Diagnostics, navigation, symbols, workspace rename. IDE precision for agents. Same LSP MCP server in both editions.
🔎	AST-Grep	Both	Pattern-aware code search and rewriting across 25 languages. Ultimate uses the MCP tools; Light uses the shared ast-grep skill with a provisioned sg.
🧠	Background Agents	Ultimate	Fire 5+ specialists in parallel. Context stays lean. Results when ready.
📚	Built-in MCPs (web/docs/code search)	Ultimate	Exa (web search), Context7 (official docs), Grep.app (GitHub search). Always on.
🔁	Goal / /goal	Ultimate	/goal sets a persistent thread objective. Idle continuation runs only when goal.enabled is true (default false).
✅	Todo Enforcer	Ultimate	Agent goes idle? System yanks it back. Your task gets done, period.
💬	Comment Checker	Both	No AI slop in comments. Code reads like a senior wrote it.
📐	Rules Injection (AGENTS.md / .omo/rules/**)	Both	Project rules and AGENTS.md auto-loaded into the agent's context at every prompt.
🎯	Ulw Loop	Light	Codex component + CLI for durable multi-goal orchestration with evidence audit. On OpenCode, use Goal / /goal instead.
🖥️	Tmux Integration	Ultimate	Full interactive terminal. REPLs, debuggers, TUIs. All live.
🔌	Claude Code Compatible	Ultimate	Your hooks, commands, skills, MCPs, and plugins? All work here.
🧬	Skill-Embedded MCPs	Ultimate	Skills carry their own MCP servers. No context bloat.
📋	Prometheus Planner	Ultimate	Interview-mode strategic planning before any execution.
🔍	/init-deep	Ultimate	Auto-generates hierarchical AGENTS.md files throughout your project. Great for both token efficiency and your agent's performance.

Edition legend. Ultimate = OpenCode-only (bunx oh-my-openagent install). Light = Codex CLI-only (npx lazycodex-ai install). Both = shipped in both editions, often with slightly different implementations under the hood.

Discipline Agents

<table><tr> <td align="center"><img src=".github/assets/sisyphus.png" height="300" /></td> <td align="center"><img src=".github/assets/hephaestus.png" height="300" /></td> </tr></table>

Sisyphus (claude-opus-5 / kimi-k3 / gpt-5.6-sol / glm-5.2 ) is your main orchestrator. He plans, delegates to specialists, and drives tasks to completion with aggressive parallel execution. He does not stop halfway. Claude Opus 5 and Kimi K3 are the recommended defaults.

Hephaestus (gpt-5.6-sol through OpenAI, GitHub Copilot, Vercel, or OpenCode at medium effort) is your autonomous deep worker. Give him a goal, not a recipe. He explores the codebase, researches patterns, and executes end-to-end without hand-holding. The Legitimate Craftsman.

Prometheus (claude-fable-5 / kimi-k3) is your strategic planner. Interview mode: he asks questions, identifies scope, and builds a detailed plan before a single line of code is touched.

Every agent is tuned to its model's specific strengths. No manual model juggling. Learn more →

Anthropic blocked OpenCode because of us. That's why Hephaestus is called "The Legitimate Craftsman." The irony is intentional.

We run best on Opus or Kimi K3, but Kimi K3 + GPT-5.6 Sol already beats vanilla Claude Code. Zero config needed.

Team Mode (v4.0)

One agent is fast. A coordinated team is devastating.

Team Mode turns oh-my-openagent from "one agent with subagents" into a real multi-agent system. A lead agent orchestrates a team of category-specialized members, all running **in paralle

…