lazycodex-ai 5.0.0-beta.90 → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/README.ja.md +41 -377
  2. package/README.ko.md +45 -377
  3. package/README.md +40 -378
  4. package/README.ru.md +50 -369
  5. package/README.zh-cn.md +50 -372
  6. package/dist/cli/index.js +90 -85
  7. package/dist/cli/install-native/plan.d.ts +4 -2
  8. package/dist/cli-node/index.js +90 -85
  9. package/package.json +1 -1
  10. package/packages/omo-codex/plugin/.codex-plugin/plugin.json +1 -1
  11. package/packages/omo-codex/plugin/components/bootstrap/hooks/hooks.json +1 -1
  12. package/packages/omo-codex/plugin/components/bootstrap/package.json +1 -1
  13. package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json +1 -1
  14. package/packages/omo-codex/plugin/components/comment-checker/package.json +1 -1
  15. package/packages/omo-codex/plugin/components/git-bash/hooks/hooks.json +2 -2
  16. package/packages/omo-codex/plugin/components/git-bash/package.json +1 -1
  17. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/hooks/hooks.json +1 -1
  18. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json +1 -1
  19. package/packages/omo-codex/plugin/components/lsp/dist/.omo-runtime-manifest.json +2 -2
  20. package/packages/omo-codex/plugin/components/lsp/hooks/hooks.json +2 -2
  21. package/packages/omo-codex/plugin/components/lsp/package.json +1 -1
  22. package/packages/omo-codex/plugin/components/rules/hooks/hooks.json +4 -4
  23. package/packages/omo-codex/plugin/components/rules/package.json +1 -1
  24. package/packages/omo-codex/plugin/components/teammode/hooks/hooks.json +1 -1
  25. package/packages/omo-codex/plugin/components/teammode/package.json +1 -1
  26. package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json +1 -1
  27. package/packages/omo-codex/plugin/components/telemetry/package.json +1 -1
  28. package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json +1 -1
  29. package/packages/omo-codex/plugin/components/ultrawork/package.json +1 -1
  30. package/packages/omo-codex/plugin/components/ulw-execute-continuation/hooks/hooks.json +1 -1
  31. package/packages/omo-codex/plugin/components/ulw-execute-continuation/package.json +1 -1
  32. package/packages/omo-codex/plugin/components/ulw-loop/hooks/hooks.json +5 -5
  33. package/packages/omo-codex/plugin/components/ulw-loop/package.json +1 -1
  34. package/packages/omo-codex/plugin/hooks/post-compact-resetting-git-bash-mcp-reminder.json +1 -1
  35. package/packages/omo-codex/plugin/hooks/post-compact-resetting-lsp-diagnostics-cache.json +1 -1
  36. package/packages/omo-codex/plugin/hooks/post-compact-resetting-project-rule-cache.json +1 -1
  37. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-comments.json +1 -1
  38. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-lsp-diagnostics.json +1 -1
  39. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-thread-title-hygiene.json +1 -1
  40. package/packages/omo-codex/plugin/hooks/post-tool-use-matching-project-rules.json +1 -1
  41. package/packages/omo-codex/plugin/hooks/post-tool-use-recording-spawn-admission.json +1 -1
  42. package/packages/omo-codex/plugin/hooks/pre-tool-use-enforcing-unlimited-goal-budget.json +1 -1
  43. package/packages/omo-codex/plugin/hooks/pre-tool-use-guarding-ulw-loop-spawns.json +1 -1
  44. package/packages/omo-codex/plugin/hooks/pre-tool-use-recommending-git-bash-mcp.json +1 -1
  45. package/packages/omo-codex/plugin/hooks/session-start-checking-auto-update.json +1 -1
  46. package/packages/omo-codex/plugin/hooks/session-start-checking-bootstrap-provisioning.json +1 -1
  47. package/packages/omo-codex/plugin/hooks/session-start-loading-project-rules.json +1 -1
  48. package/packages/omo-codex/plugin/hooks/session-start-recording-session-telemetry.json +1 -1
  49. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-execute-continuation.json +1 -1
  50. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-loop-resume.json +1 -1
  51. package/packages/omo-codex/plugin/hooks/subagent-stop-verifying-lazycodex-executor-evidence.json +1 -1
  52. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ultrawork-trigger.json +1 -1
  53. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ulw-loop-steering.json +1 -1
  54. package/packages/omo-codex/plugin/hooks/user-prompt-submit-loading-project-rules.json +1 -1
  55. package/packages/omo-codex/plugin/package-lock.json +12 -12
  56. package/packages/omo-codex/plugin/package.json +1 -1
  57. package/packages/omo-codex/plugin/skills/browser/runtime/omowright/manifest.json +1 -1
  58. package/packages/omo-codex/plugin/test/node-install-surface.test.mjs +0 -1
  59. package/packages/omo-codex/scripts/install-dist/install-local.mjs +2 -2
  60. package/packages/shared-skills/skills/browser/runtime/omowright/manifest.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  > [!NOTE]
2
- > **OmO Beta: OmO ❤️ Pi**
3
- > Try it with `bun add -g omo-ai@beta`. Memory system, CodeMode, Anthropic subscriptions, all covered.
2
+ > **OmO 5.0: OmO ❤️ Pi**
3
+ > Install it with `bun add -g omo-ai`. Memory system, CodeMode, Anthropic subscriptions, all covered.
4
4
  > [![OmO Herdr DAG - live OmO workflow DAGs in a Herdr side pane](./.github/assets/omo-herdr-dag.png)](https://github.com/jc01rho/omo-herdr-dag)
5
5
  > *Just type "mass ulw" with your prompt - now you are the master of graph engineering. Multi-model ultracode, together with a better memory system. (The right panel is [omo-herdr-dag](https://github.com/jc01rho/omo-herdr-dag).)*
6
6
 
@@ -18,433 +18,95 @@
18
18
  > [!TIP]
19
19
  > Be with us!
20
20
  >
21
- > | [<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" />](https://discord.gg/PUwSMR9XNk) | Join our [Discord community](https://discord.gg/PUwSMR9XNk) to connect with contributors and fellow `oh-my-openagent` users. |
21
+ > | [<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" />](https://discord.gg/PUwSMR9XNk) | Join our [Discord community](https://discord.gg/PUwSMR9XNk) to connect with contributors and fellow OmO users. |
22
22
  > | :-----| :----- |
23
- > | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | Updates for `oh-my-openagent` used to be posted on my X account. <br /> Since it was mistakenly suspended, [@justsisyphus](https://x.com/justsisyphus) now posts updates on my behalf. |
23
+ > | [<img alt="X link" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | Updates for OmO used to be posted on my X account. <br /> Since it was mistakenly suspended, [@justsisyphus](https://x.com/justsisyphus) now posts updates on my behalf. |
24
24
  > | [<img alt="GitHub Follow" src="https://img.shields.io/github/followers/code-yeongyu?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/code-yeongyu) | Follow [@code-yeongyu](https://github.com/code-yeongyu) on GitHub for more projects. |
25
25
 
26
26
  <!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->
27
27
 
28
28
  <div align="center">
29
29
 
30
- <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>
30
+ <a href="https://omo.dev"><img src="./.github/assets/omo-icon-light.svg" alt="OmO" width="200" /></a>
31
31
 
32
- [![Oh My OpenAgent](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent)
32
+ # OmO
33
33
 
34
- [![Preview](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-openagent#oh-my-openagent)
35
-
36
- </div>
37
-
38
- > This is oh-my-openagent, running Team Mode. With Kimi K3 and GPT-5.6 Sol.
39
-
40
- > Anthropic [**blocked OpenCode because of us.**](https://x.com/thdxr/status/2010149530486911014) **Yes, this is true.**
41
- > They want you locked in. Claude Code is a nice prison, but it's still a prison.
42
- >
43
- > You don't need to pay $200 for 2 hours of work.
44
- > 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.
45
-
46
- <div align="center">
34
+ **Your tool for real work. But it's an agent.**
47
35
 
48
36
  [![GitHub Release](https://img.shields.io/github/v/release/code-yeongyu/oh-my-openagent?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/releases)
49
- [![npm downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fomo.dev%2Fapi%2Fnpm-downloads&style=flat-square)](https://www.npmjs.com/package/oh-my-opencode)
37
+ [![npm downloads](https://img.shields.io/endpoint?url=https%3A%2F%2Fomo.dev%2Fapi%2Fnpm-downloads&style=flat-square)](https://www.npmjs.com/package/omo-ai)
50
38
  [![GitHub Contributors](https://img.shields.io/github/contributors/code-yeongyu/oh-my-openagent?color=c4f042&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/graphs/contributors)
51
- [![GitHub Forks](https://img.shields.io/github/forks/code-yeongyu/oh-my-openagent?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/network/members)
52
39
  [![GitHub Stars](https://img.shields.io/github/stars/code-yeongyu/oh-my-openagent?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/stargazers)
53
- [![GitHub Issues](https://img.shields.io/github/issues/code-yeongyu/oh-my-openagent?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/issues)
54
40
  [![License](https://img.shields.io/badge/license-SUL--1.0-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-openagent/blob/dev/LICENSE.md)
55
- [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/code-yeongyu/oh-my-openagent)
56
41
  [![Docs](https://img.shields.io/badge/docs-omo.dev-369eff?labelColor=black&logo=readthedocs&logoColor=white&style=flat-square)](https://omo.dev/docs)
57
42
 
58
- [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
43
+ [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md) | [Русский](README.ru.md)
59
44
 
60
45
  </div>
61
46
 
62
47
  <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->
63
48
 
64
- ## Reviews
65
-
66
- > "It made me cancel my Cursor subscription. Unbelievable things are happening in the open source community." - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
67
-
68
- > "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
69
-
70
- > "Knocked out 8000 eslint warnings with Oh My Opencode, just in a day" <br/>- [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)
71
-
72
- > "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](https://x.com/hargabyte/status/2007299688261882202)
73
-
74
- > "use oh-my-opencode, you will never go back" <br/>- [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)
75
-
76
- > "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." - [
77
- 苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)
78
-
79
- > "Experimenting with open code, oh my opencode and supermemory this weekend to build some minecraft/souls-like abomination."
80
- > "Asking it to add crouch animations while I go take my post-lunch walk. [Video]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)
81
-
82
- > "You guys should pull this into core and recruit him. Seriously. It's really, really, really good." <br/>- Henning Kilset
83
-
84
- > "Hire @yeon_gyu_kim if you can convince him, this dude has revolutionized opencode." <br/>- [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)
85
-
86
- > "Oh My OpenCode Is Actually Insane" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)
49
+ OmO is one `omo` command that turns your tokens into finished work: research across ten thousand sources, a deck people actually get, backends, frontends, code. It runs on senpi, our fork of [pi](https://github.com/badlogic/pi-mono), with everything below built in.
87
50
 
88
- ---
89
-
90
- # Oh My OpenAgent
91
-
92
- You're juggling Claude Code, Codex, and random OSS models. Configuring each one. Debugging agents.
93
-
94
- We did the work. Tested everything. Kept what actually shipped.
95
-
96
- Install oh-my-openagent. Type `ultrawork`. Done.
97
-
98
-
99
- ## Installation
100
-
101
- 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.
102
-
103
- **Ultimate Edition (omo for OpenCode)** is the full omo. 11 agents, 54+ lifecycle hooks, 4 built-in MCPs (websearch, context7, grep_app, lsp), all slash commands, Team Mode, `/goal`, ultrawork. Hashline edits are opt-in (`hashline_edit: true`).
104
-
105
- **Light Edition (omo for Codex CLI)** carries 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/`. There are no OpenCode `team_*` tools; Codex CLI's own spawn/collaboration surface does that work.
106
-
107
- **OmO Native (standalone, beta)** is the `omo` command with the OMO extension built in. It installs from `omo-ai@beta` and loads into neither OpenCode nor Codex. Already on the OpenCode edition? See [Migrating from OpenCode](docs/guide/migrating-from-opencode.md).
108
-
109
- Pick the edition(s) you want.
110
-
111
- ### One-line install
112
-
113
- | You want | Run | What lands on disk |
114
- | :--- | :--- | :--- |
115
- | **Ultimate** (OpenCode) | `bunx oh-my-openagent install` (TUI walks you through it) | Plugin registered in `opencode.json` + agent/model config + provider auth prompts |
116
- | **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` |
117
- | **Both** | `bunx oh-my-openagent install --platform=both` | Both of the above |
118
- | **OmO Native** (beta) | `bun add -g omo-ai@beta`, then `omo` | The `omo` command: pinned senpi engine with the OMO extension built in. Beta channel only; a bare `bun add -g omo-ai` fails by design. See the [install guide](docs/guide/installation.md#omo-native-beta-omo-via-omo-ai). |
119
-
120
- `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).
121
-
122
- ### Which edition should I pick?
123
-
124
- Already on OpenCode, or want the most-tested path? **Ultimate**. Already on Codex CLI? **Light**. Want one command without installing a host first? **OmO Native**, which ships a pinned senpi engine with OMO built in; bun is the recommended runtime for it, and the `@beta` tag is required. Do not install plain `omo` from npm; that is an unrelated package by a different author.
125
-
126
- ### For Humans
127
-
128
- **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, and humans fat-finger these. An LLM agent reads the full guide and walks every step correctly.
129
-
130
- Paste this prompt into Claude Code, AmpCode, Cursor, or any agent:
131
-
132
- ```
133
- Install and configure oh-my-openagent by following the instructions here:
134
- https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
135
- ```
136
-
137
- 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:
138
-
139
- ```bash
140
- npx lazycodex-ai install
141
- # non-interactive recommended mode:
142
- npx lazycodex-ai install --no-tui --codex-autonomous
143
- ```
144
-
145
- 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/`.
146
-
147
- ### For LLM Agents
148
-
149
- Fetch the full guide and follow it step by step:
51
+ ## Install
150
52
 
151
53
  ```bash
152
- curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
54
+ bun add -g omo-ai
55
+ omo
153
56
  ```
154
57
 
155
- The guide covers: platform selection, the subscription interview, provider authentication (Anthropic / Google / 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.
156
-
157
- ### Note on package and command names
58
+ No bun? `npm i -g omo-ai` works too. The package is `omo-ai`; the unrelated `omo` package on npm is someone else's.
158
59
 
159
- 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.
60
+ Open your project, run `omo`, describe the job. That's the whole setup.
160
61
 
161
- 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 OmO Native, installed with `bun add -g omo-ai@beta` (beta channel only; bun is the recommended runtime). 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. OmO Native'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`.
162
-
163
- ### Telemetry
164
-
165
- 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`).
166
-
167
- Opt out per product. For the main plugin, set `"telemetry": false` in the oh-my-openagent config, or export `OMO_DISABLE_POSTHOG=1` or `OMO_SEND_ANONYMOUS_TELEMETRY=0`. For the Codex CLI Light edition, export `OMO_CODEX_DISABLE_POSTHOG=1` or `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0`; the global flags also disable Codex.
168
-
169
- See [Privacy Policy](docs/legal/privacy-policy.md) and [Terms of Service](docs/legal/terms-of-service.md).
170
-
171
- ---
172
-
173
- ## Skip This README
174
-
175
- We're past the era of reading docs. Just paste this into your agent:
176
-
177
- ```
178
- 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
179
- ```
62
+ Coming from the OpenCode edition or LazyCodex? Run `omo setup` once. It carries your provider keys, custom providers, MCP servers, skills and model picks across. `omo doctor` then shows which task categories your providers can run and what the old install left behind. The full walkthrough is [Migrating from OpenCode](docs/guide/migrating-from-opencode.md).
180
63
 
64
+ `omo update` updates in place. `bun remove -g omo-ai` (or `npm uninstall -g omo-ai`) removes it.
181
65
 
182
- ## ROADMAP
66
+ ## Why OmO
183
67
 
184
- 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.
68
+ **ultrawork.** Skip the study. If a task feels hard, add `ultrawork` (or `ulw`) to your prompt. The agent reads the codebase before touching a line, plans, proves each step before moving on, checks the result on the real surface, and stops when it's done.
185
69
 
186
- If you want to contribute, read the [ROADMAP](./ROADMAP.md) first. PRs related to this refactor should use the `ROADMAP` label so they are easy to track.
187
-
188
- ## Highlights
189
-
190
- ### 🪄 `ultrawork`
191
-
192
- You're actually reading this? Wild.
193
-
194
- Install. Type `ultrawork` (or `ulw`). Done.
195
-
196
- Everything below, every feature, every optimization: you don't need to know any of it. It just works.
197
-
198
- Even with only a [ChatGPT subscription ($20)](https://chatgpt.com/), a [Kimi Code subscription ($19)](https://www.kimi.com/code) or the [GLM Coding Plan ($10)](https://z.ai/subscribe), `ultrawork` works well (this project is not affiliated; these are personal recommendations). If you're eligible for pay-per-token, Kimi and GLM models won't cost much either.
199
-
200
- | | Feature | Edition | What it does |
201
- | :---: | :------------------------------------------------------- | :------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
202
- | 🤖 | **Discipline Agents** | Ultimate | The main agent orchestrates the architect consult, Librarian, Explore and category workers. A full AI dev team in parallel. |
203
- | 🧩 | **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`. |
204
- | 👥 | **Team Mode** (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 →](docs/guide/team-mode.md) |
205
- | ⚡ | **`ultrawork` / `ulw`** | Both | One word. Every agent activates. Doesn't stop until done. |
206
- | 🚪 | **[IntentGate](https://factory.ai/news/terminal-bench)** | Ultimate | Keyword detection for `ultrawork`/`ulw`, `team`, and `hyperplan` (does not semantically classify intent). (Light edition only recognises the `ultrawork`/`ulw` keyword.) |
207
- | 🔗 | **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](https://github.com/can1357/oh-my-pi). [The Harness Problem →](https://blog.can.ac/2026/02/12/the-harness-problem/) |
208
- | 🛠️ | **LSP integration** | Both | Diagnostics, navigation, symbols, workspace rename. IDE precision for agents. Same LSP MCP server in both editions. |
209
- | 🔎 | **AST-Grep** | Both | Pattern-aware code search and rewriting across 25 languages. Both editions use the shared `ast-grep` skill with a provisioned `sg`. |
210
- | 🧠 | **Background Agents** | Ultimate | Fire 5+ specialists in parallel. Context stays lean. Results when ready. |
211
- | 📚 | **Built-in MCPs** (web/docs/code search) | Ultimate | websearch (Exa), context7 (docs), grep_app (GitHub search), lsp. Always on. |
212
- | 🔁 | **Goal / `/goal`** | Ultimate | `/goal` sets a persistent thread objective. Idle continuation runs only when `goal.enabled` is true (default false). |
213
- | ✅ | **Todo Enforcer** | Ultimate | Agent goes idle? System yanks it back. Your task gets done, period. |
214
- | 💬 | **Comment Checker** | Both | No AI slop in comments. Code reads like a senior wrote it. |
215
- | 📐 | **Rules Injection** (`AGENTS.md` / `.omo/rules/**`) | Both | Project rules and AGENTS.md auto-loaded into the agent's context at every prompt. |
216
- | 🎯 | **Ulw Loop** | Light | Codex component + CLI for durable multi-goal orchestration with evidence audit. On OpenCode, use **Goal / `/goal`** instead. |
217
- | 🖥️ | **Tmux Integration** | Ultimate | Full interactive terminal. REPLs, debuggers, TUIs. All live. |
218
- | 🔌 | **Claude Code Compatible** | Ultimate | Your hooks, commands, skills, MCPs, and plugins? All work here. |
219
- | 🧬 | **Skill-Embedded MCPs** | Ultimate | Skills carry their own MCP servers. No context bloat. |
220
- | 📋 | **Ultrawork Planner** | Ultimate | Interview-mode strategic planning before execution starts. |
221
- | 🔍 | **`/init-deep`** | Ultimate | Auto-generates hierarchical `AGENTS.md` files throughout your project. Great for both token efficiency and your agent's performance. |
222
-
223
- > **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.
224
-
225
- ### Discipline Agents
226
-
227
- **The main agent** runs on your session model and is your orchestrator. It plans, delegates to specialists, and drives tasks to completion with aggressive parallel execution. It doesn't stop halfway. Give it a goal, not a recipe: it explores the codebase, researches patterns, and executes end-to-end without hand-holding. *The Legitimate Craftsman.*
228
-
229
- **The Ultrawork Planner** (`/ulw-plan`) is your strategic planner. Interview mode: it asks questions, identifies scope, and builds a detailed plan before a single line of code is touched. `/ulw-execute` then carries that plan out in the same session.
230
-
231
- Every prompt preset is tuned to its model's specific strengths. No manual model juggling. [Learn more →](docs/guide/overview.md)
232
-
233
- > Anthropic [blocked OpenCode because of us.](https://x.com/thdxr/status/2010149530486911014) That's why we call the main agent "The Legitimate Craftsman." The irony is intentional.
234
- >
235
- > We run best on Opus or Kimi K3, but Kimi K3 + GPT-5.6 Sol already beats vanilla Claude Code. Zero config needed.
236
-
237
- ### Team Mode
238
-
239
- One agent is fast. A coordinated team is *devastating*.
240
-
241
- **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 parallel** and communicating through dedicated tools (`team_create`, `team_send_message`, `team_task_create`, `team_status`, ...). Watch every member work simultaneously in a tmux layout with focus + grid windows.
242
-
243
- ```jsonc
244
- // ~/.omo/omo.jsonc (or project .omo/omo.jsonc)
245
- {
246
- "team_mode": {
247
- "enabled": true,
248
- "max_parallel_members": 4,
249
- "tmux_visualization": true
250
- }
251
- }
252
- ```
70
+ **Hundreds of agents, one keyword.** Type `mass ulw` and the whole job becomes a graph of agents: deep research over thousands of sources, a full machine-learning pipeline, a migration nobody wants to do. Each part runs on the model that fits it, in parallel, and gets checked before anything is called done.
253
71
 
254
- Restart opencode and the `team_*` tool family appears. Two skills already ride on top of it. `hyperplan` sends 5 hostile agents at your plan from orthogonal angles before a single line of code is written. `security-research` runs 3 vulnerability hunters and 2 PoC engineers over your codebase in parallel, with severity calibrated by *actual exploitability*.
72
+ **Kibitzer. Your agent doesn't forget you, or your work.** Memory lives in a git repository of markdown files. A small, cheap model sits beside the expensive main agent, reads what you've done before, and nudges the main agent before it repeats a mistake. You stop re-explaining yourself.
255
73
 
256
- > **Off by default. Enable it when you want it.** [Full Team Mode guide →](docs/guide/team-mode.md)
74
+ **Mix models without thinking about it.** Use the frontier models you love together with the cheap ones. Just sign in: `/login` covers Claude, ChatGPT, Kimi and GLM subscriptions. Every model ships with a system prompt tuned for it, so you never pick the wrong one.
257
75
 
258
- ### Agent Orchestration
76
+ **High-quality skills, only the ones you need.** Your model is smart, but it still doesn't know a lot about solving real-world problems. OmO ships the missing knowledge as skills, browser use included, and loads only what the task needs.
259
77
 
260
- When the main agent delegates to a subagent, it doesn't pick a model. It picks a **category**. The category maps automatically to the right model:
261
-
262
- | Category | What it's for |
263
- | :------------------- | :--------------------------------- |
264
- | `visual-engineering` | Visual design, UI/UX, frontend |
265
- | `deep` | Deep work across visual and technical domains |
266
- | `quick` | Single-file changes, typos |
267
- | `ultrabrain` | Hard logic, architecture decisions |
268
-
269
- The agent says what kind of work it needs; the harness picks the right model. `ultrabrain` routes to GPT-6 Astra max (falling back to GPT-5.6 Sol), `deep-high` to GPT-6 Astra xhigh, and `deep-low` to GPT-6 Sol Fast medium (then GPT-6 Sol where the Fast tier is not served). You touch nothing.
270
-
271
- ### Claude Code Compatibility
272
-
273
- You dialed in your Claude Code setup. Good.
274
-
275
- Every hook, command, skill, MCP, plugin works here unchanged. Full compatibility, including plugins.
276
-
277
- ### World-Class Tools for Your Agents
278
-
279
- LSP, AST-Grep, Tmux, and MCP, actually integrated, not duct-taped together. LSP gives every agent `lsp_rename`, `lsp_goto_definition`, `lsp_find_references` and `lsp_diagnostics`, IDE precision included. AST-Grep does pattern-aware code search and rewriting across 25 languages. Tmux is a full interactive terminal, so REPLs, debuggers and TUI apps stay in session. MCP brings web search, official docs and GitHub code search, all baked in.
280
-
281
- ### Skill-Embedded MCPs
282
-
283
- MCP servers eat your context budget. We fixed that.
284
-
285
- Skills bring their own MCP servers. They spin up on demand, scoped to the task, and go away when done. The context window stays small.
286
-
287
- ### Codes Better. Hash-Anchored Edits
288
-
289
- The harness problem is real. Most agent failures aren't the model's fault; it's the edit tool.
290
-
291
- > *"None of these tools give the model a stable, verifiable identifier for the lines it wants to change... They all rely on the model reproducing content it already saw. When it can't - and it often can't - the user blames the model."*
292
- >
293
- > <br/>- [Can Bölük, The Harness Problem](https://blog.can.ac/2026/02/12/the-harness-problem/)
294
-
295
- Inspired by [oh-my-pi](https://github.com/can1357/oh-my-pi), we built **Hashline**. When `hashline_edit` is enabled, every line the agent reads comes back tagged with a content hash:
296
-
297
- ```
298
- 11#VK| function hello() {
299
- 22#XJ| return "world";
300
- 33#MB| }
301
- ```
302
-
303
- The agent edits by referencing those tags. If the file has changed since the last read, the hash won't match and the edit is rejected before it can corrupt the file. No whitespace reproduction. No stale-line errors.
304
-
305
- ### Deep Initialization. `/init-deep`
306
-
307
- Run `/init-deep`. It generates hierarchical `AGENTS.md` files:
308
-
309
- ```
310
- project/
311
- ├── AGENTS.md ← project-wide context
312
- ├── src/
313
- │ ├── AGENTS.md ← src-specific context
314
- │ └── components/
315
- │ └── AGENTS.md ← component-specific context
316
- ```
317
-
318
- Agents auto-read relevant context. Zero manual management.
319
-
320
- ### Planning. The Ultrawork Planner
321
-
322
- Complex task? Don't prompt and pray.
323
-
324
- The Ultrawork Planner (`/ulw-plan`) **interviews you like a real engineer**, identifies scope and ambiguities, and writes a reviewed plan to `.omo/plans/` before touching code. `/ulw-execute` then has the main agent execute that plan in the same session. The agent knows what it's building before it starts.
325
-
326
- ### Skills
327
-
328
- Skills aren't just prompts. Each brings domain-tuned system instructions, embedded MCP servers on demand, and scoped permissions so agents stay in bounds.
329
-
330
- Built-ins include `playwright` (browser automation), `git-master` (atomic commits, rebase surgery) and `frontend` (design-first UI).
331
-
332
- Add your own under `.opencode/skills/*/SKILL.md` or `~/.config/opencode/skills/*/SKILL.md`.
333
-
334
- **Want the full feature breakdown?** See the **[Features Documentation](docs/reference/features.md)** for agents, hooks, tools, MCPs, and everything else in detail.
335
-
336
- ---
337
-
338
- > **New to oh-my-openagent?** Read the **[Overview](docs/guide/overview.md)** to understand what you have, or check the **[Orchestration Guide](docs/guide/orchestration.md)** for how agents collaborate.
339
-
340
- ## Uninstallation
341
-
342
- Removing oh-my-openagent takes four steps.
343
-
344
- ### Remove the plugin from your OpenCode config
345
-
346
- Edit `~/.config/opencode/opencode.json` (or `opencode.jsonc`) and remove either `"oh-my-openagent"` or the legacy `"oh-my-opencode"` entry from the `plugin` array:
347
-
348
- ```bash
349
- # Using jq
350
- jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
351
- ~/.config/opencode/opencode.json > /tmp/oc.json && \
352
- mv /tmp/oc.json ~/.config/opencode/opencode.json
353
- ```
354
-
355
- ### Remove configuration files (optional)
356
-
357
- ```bash
358
- # Remove the runtime config files
359
- rm -f ~/.omo/omo.jsonc ~/.omo/omo.json
360
-
361
- # Remove project config (if exists)
362
- rm -f .omo/omo.jsonc .omo/omo.json
363
-
364
- # Remove leftover legacy migration backups (if any)
365
- rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
366
- ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json \
367
- .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
368
- .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
369
- ```
370
-
371
- ### Verify removal
372
-
373
- ```bash
374
- opencode --version
375
- # Plugin should no longer be loaded
376
- ```
377
-
378
- ### Remove omo-codex (Codex CLI Light edition)
379
-
380
- ```bash
381
- npx lazycodex-ai uninstall
382
- # backward-compatible alias:
383
- npx lazycodex-ai cleanup
384
-
385
- omo-agent-toolkit uninstall --platform=codex
386
- # backward-compatible alias:
387
- omo-agent-toolkit cleanup --platform=codex
388
- ```
389
-
390
- The uninstall command removes managed `sisyphuslabs` Codex cache/marketplace state, strips `omo@sisyphuslabs` plugin and hook-state blocks from `~/.codex/config.toml` after writing a backup, and removes agent TOML links listed in the install manifest. If a specific project still has old project-local Codex plugin state, run the command from that project or pass `--project <path>`; it repairs known project-local `.codex/config.toml` conflicts and reports project-local `.codex` artifacts without deleting project-owned files.
391
-
392
- ## Features
393
-
394
- Features you'll think should've always existed. Once you use them, you can't go back.
395
-
396
- See the full [Features Documentation](docs/reference/features.md). The short version follows.
397
-
398
- The main agent orchestrates; the Ultrawork Planner (`/ulw-plan`), the architect consult (architecture and debugging), Librarian (docs and code search), Explore (fast codebase grep) and the Multimodal Looker specialize, and background agents run several of them in parallel like a real dev team. LSP and AST tools cover refactoring, rename, diagnostics and AST-aware code search. The hash-anchored edit tool (opt-in via `hashline_edit: true`) validates `LINE#ID` references before applying every change, so edits are surgical and stale-line errors are gone.
399
-
400
- AGENTS.md, README.md and conditional rules are injected into context automatically. Claude Code hooks, commands, skills, agents and MCPs run unchanged. The built-in MCPs (websearch via Exa, context7 for docs, grep_app for GitHub search, lsp) are injected at runtime by the plugin, which is why they do not show up in `opencode mcp list` (see the [MCP docs](docs/reference/features.md#native-vs-plugin-injected-mcps)). Session tools list, read, search and analyze session history.
401
-
402
- Goal, the Todo Enforcer, the Comment Checker and Think Mode keep a run on track. `bunx oh-my-opencode doctor` checks plugin registration, config, models and environment. `fallback_models` can mix plain model strings with per-fallback object settings in the same array, agent prompts can load from files with `file://`, and sessions recover from session errors, context window limits and API failures on their own. Agent-model matching is part of the [Installation Guide](docs/guide/installation.md#step-5-understand-your-model-setup).
78
+ **Everything else is crafted.** Independent tool calls run together in one small program, so twenty reads are one round trip. Malformed tool arguments are repaired before they run. Waiting on a build or a deploy is a subscription, not polling. Long work keeps a record of what was checked, so a restarted session picks up where it stopped. Config, skills and prompts reload live.
403
79
 
404
80
  ## Configuration
405
81
 
406
- Opinionated defaults, adjustable if you insist.
82
+ Opinionated defaults, adjustable if you insist. Your settings live in `~/.omo/omo.jsonc`, and a project can add its own `.omo/omo.jsonc`; the closest file wins. Every key is in the [configuration reference](docs/reference/configuration.md).
407
83
 
408
- See the [Configuration Documentation](docs/reference/configuration.md). The short version follows.
409
-
410
- Config lives in the user file `~/.omo/omo.jsonc` plus walked project `.omo/omo.jsonc` files up to `$HOME`; the closest one wins, and legacy `oh-my-*` files are migrated once into `omo.jsonc`. JSONC is accepted, comments and trailing commas included. You can override models, temperatures, prompts and permissions for any agent, set concurrency limits for background tasks per provider or model, and turn any of the 54+ lifecycle hooks (61 with Team Mode) off through `disabled_hooks`.
411
-
412
- The main agent orchestrates with the Ultrawork Planner (`/ulw-plan`) and the Plan Consultant. Delegation goes through categories (`visual-engineering`, `ultrabrain`, `deep`, `artistry`, `quick`, `unspecified-low`, `unspecified-high`, `writing`, plus custom names). Built-in skills include `playwright` (browser automation) and `git-master` (atomic commits). The built-in MCPs (websearch via Exa, context7, grep_app, lsp) are runtime-injected and not shown in `opencode mcp list`; LSP support includes the refactoring tools. Experimental options cover aggressive truncation, preemptive compaction, and more.
413
-
414
-
415
- ## Author's Note
84
+ ## Docs
416
85
 
417
- **Want the philosophy?** Read the [Ultrawork Manifesto](docs/manifesto.md).
86
+ - [omo.dev/docs](https://omo.dev/docs)
87
+ - [Migrating from OpenCode](docs/guide/migrating-from-opencode.md)
88
+ - [Configuration reference](docs/reference/configuration.md)
89
+ - [Features](docs/reference/features.md)
90
+ - [Ultrawork Manifesto](docs/manifesto.md)
418
91
 
419
- ---
420
-
421
- I burned through $24K in LLM tokens on personal projects. Tried every tool. Configured everything to death. OpenCode won.
422
-
423
- Every problem I hit, the fix is baked into this plugin. Install and go.
424
-
425
- If OpenCode is Debian/Arch, oh-my-openagent is Ubuntu/[Omarchy](https://omarchy.org/).
426
-
427
- Heavily influenced by [AmpCode](https://ampcode.com) and [Claude Code](https://code.claude.com/docs/overview). Features ported, often improved. Still building. It's **Open**Code.
92
+ ## Reviews
428
93
 
429
- Other harnesses promise multi-model orchestration. We ship it. Stability too. And features that actually work.
94
+ > "It made me cancel my Cursor subscription. Unbelievable things are happening in the open source community." - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
430
95
 
431
- I'm this project's most obsessive user. Which model has the sharpest logic? Who's the debugging god? Who writes the best prose? Who dominates frontend, who owns backend, what's fastest for daily driving, what are competitors shipping?
96
+ > "If Claude Code does in 7 days what a human does in 3 months, OmO does it in 1 hour." <br/>- B, Quant Researcher
432
97
 
433
- This plugin is the distillation. Take the best. Got improvements? PRs welcome.
98
+ > "You guys should pull this into core and recruit him. Seriously. It's really, really, really good." <br/>- Henning Kilset
434
99
 
435
- **Stop agonizing over harness choices.**
436
- **I'll research, steal the best, and ship it here.**
100
+ ## Author's Note
437
101
 
438
- Sounds arrogant? Have a better way? Contribute. You're welcome.
102
+ When I have to take the wheel back from an agent, that isn't teamwork. The system failed. OmO is built on that idea. You say what you want; the agent researches, plans, writes code you couldn't tell from a senior engineer's, verifies it, and keeps going until it's finished. It spends tokens when they buy real speed and routes the easy parts to cheap models.
439
103
 
440
- No affiliation with any project or model mentioned. Just personal experimentation.
104
+ I'm this project's most obsessive user. Which model has the sharpest logic? Who writes the best prose? What did everyone else ship this week? OmO is where those answers land. Have a better way? PRs welcome.
441
105
 
442
- The LazyCodex name is inspired by [LazyVim](https://github.com/LazyVim/LazyVim). The Ultragoal and UltraQA ideas come from [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex), reimplemented from concept for OmO.
106
+ The goal is an agent you stop noticing. You flip the switch, the light turns on. The long version is the [Ultrawork Manifesto](docs/manifesto.md).
443
107
 
444
- 99% of this project was built with OpenCode. I don't really know TypeScript, **but I personally reviewed and largely rewrote this doc.**
108
+ No affiliation with any project or model mentioned. The Ultragoal and UltraQA ideas come from [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex), reimplemented from concept for OmO.
445
109
 
446
110
  ## Loved by professionals at
447
111
 
448
112
  [Indent](https://indentcorp.com), makers of Spray (influencer marketing solution), vovushop (cross-border commerce platform) and vreview (AI commerce review marketing solution). [Google](https://google.com). [Microsoft](https://microsoft.com). [Vercel](https://vercel.com). [ELESTYLE](https://elestyle.jp), makers of elepay (multi-mobile payment gateway) and OneQR (mobile application SaaS for cashless solutions). [Deepgram](https://deepgram.com).
449
-
450
- *Special thanks to [@junhoyeo](https://github.com/junhoyeo) for this amazing hero image.*