oh-my-opencode 4.5.1 → 4.5.12

package/README.zh-cn.md

@@ -67,7 +67,7 @@
 
 ## 评价
 
-> "因为它，我取消了 Cursor 的订阅。开源社区正在发生令人难以置信的事情。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
+> "因为它，我取消了 Cursor 的订阅。令人震撼的事在开源社区发生了。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)
 
 > "如果人类需要 3 个月完成的事情 Claude Code 需要 7 天，那么 Sisyphus 只需要 1 小时。它会一直工作直到任务完成。它是一个极度自律的智能体。" <br/>- B, 量化研究员
 
@@ -93,7 +93,7 @@
 
 你同时折腾着 Claude Code、Codex、各种奇奇怪怪的开源模型。配工作流。给 Agent 调 Bug。
 
-这些事我们替你做完了。全部测试过。只留下真正跑得起来的。
+这些事我们替你做完了。全部测试过。只留下真正跑得起来的代码。
 
 装上 oh-my-openagent。敲 `ultrawork`。就完事了。
 
@@ -109,7 +109,7 @@ 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
 ```
 
-或者你也可以直接去读 [安装指南](docs/guide/installation.md)，但说真的，让 Agent 去干吧。人类配环境总是容易敲错字母。
+或者你也可以直接去读 [安装指南](docs/guide/installation.md)，但说真的，让 Agent 去干吧。人类在配置环境的时候，总是容易敲错字母。
 
 ### 给 LLM Agent 看的
 
@@ -123,6 +123,8 @@ curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/head
 
 匿名遥测默认开启，用于统计活跃安装数(DAU/WAU/MAU)。每台机器每个 UTC 日最多发送一次事件,使用哈希化的安装标识符,绝不会使用原始主机名,且不会创建 PostHog person profile。可通过 `OMO_SEND_ANONYMOUS_TELEMETRY=0` 或 `OMO_DISABLE_POSTHOG=1` 禁用。详见 [隐私政策](docs/legal/privacy-policy.md) 和 [服务条款](docs/legal/terms-of-service.md)。
 
+**Ultimate 与 Light:** oh-my-openagent 以同一产品的两个版本发布。**Ultimate 版本**（`bunx omo install` 或 `--platform=opencode`，默认值）在 OpenCode 上提供完整功能 —— 11 个智能体、54+ 个生命周期钩子、Team Mode、所有 MCP、所有斜杠命令、IntentGate 模式。**Light 版本**（`bunx omo install --platform=codex`）仅提供能够干净地移植到 OpenAI Codex CLI 插件系统的 5 个组件（`rules`、`comment-checker`、`lsp`、`ultrawork`、`ulw-loop`）。`bunx lazycodex install` 是 `--platform=codex` 的快捷别名。要同时安装两个版本，使用 `--platform=both`。Codex 专用遥测可通过 `OMO_CODEX_DISABLE_POSTHOG=1` 或 `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0` 禁用。
+
 ---
 
 ## 跳过这个 README 吧
@@ -133,6 +135,12 @@ curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/head
 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
 ```
 
+## 路线图
+
+我们正在重构代码库以支持多个代理 harness（OpenCode、Codex、Pi、Claude Code 等）。当前最紧迫的任务是包分层重构：将纯 TypeScript 核心逻辑、MCP 服务器、技能和适配器 shim 分离到不同的层，以便跨 harness 复用而不产生重复。
+
+如果你有兴趣贡献，请先阅读 [ROADMAP](./ROADMAP.md)。与此重构相关的 PR 请使用 `ROADMAP` 标签，以便我们追踪。
+
 
 ## 核心亮点
 
@@ -150,24 +158,29 @@ Read this and tell me why it's not just another boilerplate: https://raw.githubu
 - [GLM Coding 套餐 ($10)](https://z.ai/subscribe)
 - 如果你能使用按 token 计费的方式，用 Kimi 和 Gemini 模型花不了多少钱。
 
-|       | 特性                                                            | 功能说明                                                                                                                                                                        |
-| :---: | :-------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-|   🤖   | **自律军团 (Discipline Agents)**                                | Sisyphus 负责调度 Hephaestus、Oracle、Librarian 和 Explore。一支完整的 AI 开发团队并行工作。                                                                                    |
-|   👥   | **Team Mode** (v4.0, 选择性启用)                                 | 领导 Agent + 最多 8 个并行成员，实时 tmux 可视化，专用 `team_*` 工具家族。驱动 `hyperplan`(5 个敌对评论者) 和 `security-research`(3 个猎手 + 2 个 PoC 工程师)。[文档 →](docs/guide/team-mode.md) |
-|   ⚡   | **`ultrawork` / `ulw`**                                         | 一键触发，所有智能体出动。任务完成前绝不罢休。                                                                                                                                  |
-|   🚪   | **[IntentGate 意图门](https://factory.ai/news/terminal-bench)** | 真正行动前，先分析用户的真实意图。彻底告别被字面意思误导的 AI 废话。                                                                                                            |
-|   🔗   | **基于哈希的编辑工具**                                          | 每次修改都通过 `LINE#ID` 内容哈希验证、0% 错误修改。灵感来自 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[The Harness Problem →](https://blog.can.ac/2026/02/12/the-harness-problem/) |
-|   🛠️   | **LSP + AST-Grep**                                              | 工作区级别的重命名、构建前诊断、基于 AST 的重写。为 Agent 提供 IDE 级别的精度。                                                                                                 |
-|   🧠   | **后台智能体**                                                  | 同时发射 5+ 个专家并行工作。保持上下文干净，随时获取成果。                                                                                                                      |
-|   📚   | **内置 MCP**                                                    | Exa（网络搜索）、Context7（官方文档）、Grep.app（GitHub 源码搜索）。默认开启。                                                                                                  |
-|   🔁   | **Ralph Loop / `/ulw-loop`**                                    | 自我引用闭环。达不到 100% 完成度绝不停止。                                                                                                                                      |
-|   ✅   | **Todo 强制执行**                                               | Agent 想要摸鱼？系统直接揪着领子拽回来。你的任务，必须完成。                                                                                                                    |
-|   💬   | **注释审查员**                                                  | 剔除带有浓烈 AI 味的冗余注释。写出的代码就像老练的高级工程师写的。                                                                                                              |
-|   🖥️   | **Tmux 集成**                                                   | 完整的交互式终端支持。跑 REPL、用调试器、用 TUI 工具，全都在实时会话中完成。                                                                                                    |
-|   🔌   | **Claude Code 兼容**                                            | 你现有的 Hooks、命令、技能、MCP 和插件？全都能无缝迁移过来。                                                                                                                    |
-|   🎯   | **技能内嵌 MCP**                                                | 技能自带其所需的 MCP 服务器。按需开启，不会撑爆你的上下文窗口。                                                                                                                 |
-|   📋   | **Prometheus 规划师**                                           | 动手写代码前，先通过访谈模式做好战略规划。                                                                                                                                      |
-|   🔍   | **`/init-deep`**                                                | 在整个项目目录层级中自动生成 `AGENTS.md`。不仅省 Token，还能大幅提升 Agent 理解力。                                                                                             |
+|       | 特性                                                            | Editions | 功能说明                                                                                                                                                                        |
+| :---: | :-------------------------------------------------------------- | :------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+|   🤖   | **自律军团 (Discipline Agents)**                                | Ultimate | Sisyphus 负责调度 Hephaestus、Oracle、Librarian 和 Explore。一支完整的 AI 开发团队并行工作。                                                                                    |
+|   🧩   | **Codex CLI Light Edition**                                      | Light    | 在 OpenAI Codex CLI 中运行的 omo 的 5 个可移植组件 (rules, comment-checker, LSP, ultrawork, ulw-loop)。安装: `bunx omo install --platform=codex`。                              |
+|   👥   | **Team Mode** (v4.0, 选择性启用)                                 | Ultimate | 领导 Agent + 最多 8 个并行成员，实时 tmux 可视化，专用 `team_*` 工具家族。驱动 `hyperplan`(5 个敌对评论者) 和 `security-research`(3 个猎手 + 2 个 PoC 工程师)。[文档 →](docs/guide/team-mode.md) |
+|   ⚡   | **`ultrawork` / `ulw`**                                         | Both     | 一键触发，所有智能体(Ultimate)或 Codex `ultrawork` 组件(Light)出动。任务完成前绝不罢休。                                                                                          |
+|   🚪   | **[IntentGate 意图门](https://factory.ai/news/terminal-bench)** | Ultimate | 真正行动前，先分析用户的真实意图。触发 `search` / `analyze` / `team` / `hyperplan`。(Light 仅 hook `ulw` / `ultrawork`。)                                                       |
+|   🔗   | **基于哈希的编辑工具**                                          | Ultimate | 每次修改都通过 `LINE#ID` 内容哈希验证、0% 错误修改。灵感来自 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[The Harness Problem →](https://blog.can.ac/2026/02/12/the-harness-problem/) (Codex 使用其原生 `apply_patch`。) |
+|   🛠️   | **LSP + AST-Grep**                                              | Ultimate | 工作区级别的重命名、构建前诊断、基于 AST 的重写。为 Agent 提供 IDE 级别的精度。(LSP 在 Light 中也通过 `lsp` 组件提供; AST-Grep 仅 Ultimate。)                                   |
+|   🧠   | **后台智能体**                                                  | Ultimate | 同时发射 5+ 个专家并行工作。保持上下文干净，随时获取成果。                                                                                                                      |
+|   📚   | **内置 MCP**                                                    | Ultimate | Exa（网络搜索）、Context7（官方文档）、Grep.app（GitHub 源码搜索）。默认开启。(Light 仅 LSP MCP。)                                                                              |
+|   🔁   | **Ralph Loop / `/ulw-loop`**                                    | Ultimate | 自我引用闭环。达不到 100% 完成度绝不停止。                                                                                                                                      |
+|   ✅   | **Todo 强制执行** (Boulder)                                     | Ultimate | Agent 想要摸鱼？系统直接揪着领子拽回来。你的任务，必须完成。                                                                                                                    |
+|   💬   | **注释审查员**                                                  | Both     | 剔除带有浓烈 AI 味的冗余注释。同一个 `@code-yeongyu/comment-checker` 二进制在两个版本中运行。                                                                                    |
+|   📜   | **Rules Injection**                                             | Both     | `AGENTS.md` / `CLAUDE.md` / `.omo/rules/**` 的分层上下文注入。Ultimate 中为 hook，Light 中为 `rules` 组件。                                                                       |
+|   🧬   | **Ulw Loop**                                                   | Light    | 基于 `.omo/ulw-loop/` 证据审计的持久化多目标编排。目前仅 Codex 可用; OpenCode 侧的移植在路线图上。                                                                              |
+|   🖥️   | **Tmux 集成**                                                   | Ultimate | 完整的交互式终端支持。跑 REPL、用调试器、用 TUI 工具，全都在实时会话中完成。                                                                                                    |
+|   🔌   | **Claude Code 兼容**                                            | Ultimate | 你现有的 Hooks、命令、技能、MCP 和插件？全都能无缝迁移过来。(Codex 拥有其自己的原生插件系统。)                                                                                   |
+|   🎯   | **技能内嵌 MCP**                                                | Ultimate | 技能自带其所需的 MCP 服务器。按需开启，不会撑爆你的上下文窗口。                                                                                                                 |
+|   📋   | **Prometheus 规划师**                                           | Ultimate | 动手写代码前，先通过访谈模式做好战略规划。                                                                                                                                      |
+|   🔍   | **`/init-deep`**                                                | Ultimate | 在整个项目目录层级中自动生成 `AGENTS.md`。不仅省 Token，还能大幅提升 Agent 理解力。                                                                                             |
+
+> **Editions 图例。** **Ultimate** = 仅 OpenCode (`bunx omo install`)。**Light** = 仅 Codex CLI (`bunx omo install --platform=codex`)。**Both** = 两个版本均提供 (内部实现可能略有不同)。
 
 ### 自律军团 (Discipline Agents)
 
@@ -339,6 +352,14 @@ Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动
    # 这个时候就应该没有任何关于插件的输出信息了
    ```
 
+4. **移除 omo-codex（Codex CLI Light 版本）**
+
+   ```bash
+   rm -rf ~/.codex/plugins/cache/sisyphuslabs
+   ```
+
+   然后打开 `~/.codex/config.toml`，删除 `[marketplaces.sisyphuslabs]`、`[plugins."omo@sisyphuslabs"]` 以及所有 `[hooks.state."omo@sisyphuslabs:..."]` 区块。
+
 ## Features
 
 那种"这个功能本来就该一直存在"的感觉。一用就回不去。
@@ -352,7 +373,7 @@ Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动
 - **基于哈希的编辑工具**: `LINE#ID` 引用在应用每次修改前都会验证内容。外科手术级编辑，零陈旧行错误
 - **上下文注入**: 自动注入 AGENTS.md、README.md、条件规则
 - **Claude Code 兼容**: 完整的 Hook 系统、命令、技能、Agents、MCP
-- **内置 MCP**: websearch（Exa）、context7（文档）、grep_app（GitHub 检索）
+- **内置 MCP**: websearch（Exa）、context7（文档）、grep_app（GitHub 检索） ——由插件在运行时注入，不会显示在 `opencode mcp list`  中(参见文档 [MCP docs](docs/reference/features.md#native-vs-plugin-injected-mcps))
 - **会话工具**: 列出、读取、搜索、分析会话历史
 - **效率功能**: Ralph Loop、Todo Enforcer、Comment Checker、Think Mode 等
 - **Doctor 命令**: 内置诊断（`bunx oh-my-opencode doctor`），验证插件注册、配置、模型和环境
@@ -368,7 +389,7 @@ Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动
 详细内容见 [Configuration Documentation](docs/reference/configuration.md)。
 
 **简要概览：**
-- **配置文件位置**: 兼容性层同时识别 `oh-my-openagent.json[c]` 和旧的 `oh-my-opencode.json[c]` 插件配置文件。现有安装仍大多使用旧文件名。
+- **配置文件位置**: 使用用户全局配置，同时会从当前目录向上查找 `.opencode/oh-my-openagent.json[c]`（查到 `$HOME` 为止），离当前目录越近的优先级越高。旧版 `oh-my-opencode.json[c]` 仍然有效。
 - **JSONC 支持**: 支持注释和尾逗号
 - **Agents**: 可对任意 Agent 覆盖模型、temperature、prompts 和权限
 - **内置技能**: `playwright`（浏览器自动化）、`git-master`（原子提交）
@@ -376,7 +397,7 @@ Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动
 - **后台任务**: 按 provider/model 配置并发上限
 - **类别**: 按领域的任务委托（`visual`、`business-logic`、自定义）
 - **Hooks**: 54+ 内置生命周期 Hook（启用 Team Mode 时为 61 个），都可以通过 `disabled_hooks` 控制
-- **MCPs**: 内置 websearch（Exa）、context7（文档）、grep_app（GitHub 检索）
+- **MCPs**: 内置 websearch（Exa）、context7（文档）、grep_app（GitHub 检索）——由插件在运行时注入，不会显示在 `opencode mcp list`  中
 - **LSP**: 包括重构工具的完整 LSP 支持
 - **Experimental**: 激进截断、自动 resume 等
 

package/bin/oh-my-opencode.js

@@ -5,7 +5,14 @@
 import { spawnSync } from "node:child_process";
 import { readFileSync } from "node:fs";
 import { createRequire } from "node:module";
-import { getPlatformPackageCandidates, getBinaryPath } from "./platform.js";
+import { basename } from "node:path";
+import { fileURLToPath } from "node:url";
+import {
+  getPlatformPackageCandidates,
+  getBinaryPath,
+  getPackageBareName,
+  resolvePlatformPackageBaseName,
+} from "./platform.js";
 
 const require = createRequire(import.meta.url);
 
@@ -72,6 +79,10 @@ function getSignalExitCode(signal) {
 }
 
 function getPackageBaseName() {
+  return resolvePlatformPackageBaseName(getWrapperPackageName());
+}
+
+function getWrapperPackageName() {
   try {
     const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
     return packageJson.name || "oh-my-opencode";
@@ -80,10 +91,37 @@ function getPackageBaseName() {
   }
 }
 
+function getWrapperPackageRoot() {
+  return fileURLToPath(new URL("..", import.meta.url));
+}
+
+/**
+ * Determine which bin name the user invoked us with (oh-my-opencode, oh-my-openagent, omo, lazycodex).
+ * Propagated to the compiled CLI binary via OMO_INVOCATION_NAME so it can route accordingly
+ * (e.g. `lazycodex` defaults to the Codex install flow).
+ * @returns {string}
+ */
+function getInvocationName(wrapperPackageName) {
+  if (process.env.OMO_INVOCATION_NAME) {
+    return process.env.OMO_INVOCATION_NAME;
+  }
+  if (getPackageBareName(wrapperPackageName) === "lazycodex") {
+    return "lazycodex";
+  }
+  const argv1 = process.argv[1] ?? "";
+  if (!argv1) {
+    return "oh-my-opencode";
+  }
+  return basename(argv1, ".js").replace(/\.exe$/, "");
+}
+
 function main() {
   const { platform, arch } = process;
   const libcFamily = getLibcFamily();
-  const packageBaseName = getPackageBaseName();
+  const wrapperPackageName = getWrapperPackageName();
+  const invocationName = getInvocationName(wrapperPackageName);
+
+  const packageBaseName = resolvePlatformPackageBaseName(wrapperPackageName);
   const avx2Supported = supportsAvx2();
   
   let packageCandidates;
@@ -119,11 +157,18 @@ function main() {
     process.exit(1);
   }
 
+  const childEnv = {
+    ...process.env,
+    OMO_INVOCATION_NAME: invocationName,
+    OMO_WRAPPER_PACKAGE_ROOT: getWrapperPackageRoot(),
+  };
+
   for (let index = 0; index < resolvedBinaries.length; index += 1) {
     const currentBinary = resolvedBinaries[index];
     const hasFallback = index < resolvedBinaries.length - 1;
     const result = spawnSync(currentBinary.binPath, process.argv.slice(2), {
       stdio: "inherit",
+      env: childEnv,
     });
 
     if (result.error) {

package/bin/oh-my-opencode.test.ts

@@ -0,0 +1,174 @@
+/// <reference types="bun-types" />
+
+import { afterEach, describe, expect, test } from "bun:test";
+import { spawnSync } from "node:child_process";
+import { chmod, cp, mkdir, mkdtemp, readFile, realpath, rm, symlink, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { getPlatformPackageCandidates } from "./platform.js";
+
+const testRoots: string[] = [];
+
+afterEach(async () => {
+  await Promise.all(testRoots.splice(0).map((path) => rm(path, { recursive: true, force: true })));
+});
+
+describe("lazycodex bin wrapper", () => {
+  test("runs the platform binary so npx lazycodex does not require Bun", async () => {
+    // #given
+    const fixture = await createLazyCodexFixture();
+    const nodePath = Bun.which("node") ?? "node";
+
+    // #when
+    const result = spawnSync(nodePath, [fixture.lazycodexBin, "install", "--no-tui"], {
+      encoding: "utf8",
+      env: {
+        ...process.env,
+        CAPTURE_DIR: fixture.captureDir,
+        PATH: fixture.fakeBinDir,
+      },
+    });
+
+    // #then
+    expect(result.status).toBe(23);
+    expect((await readFile(join(fixture.captureDir, "env"), "utf8")).trim()).toBe("lazycodex");
+    expect(await canonicalizePackageRootCapture(fixture)).toBe(await realpath(fixture.root));
+    expect((await readFile(join(fixture.captureDir, "args"), "utf8")).trim().split("\n")).toEqual([
+      "install",
+      "--no-tui",
+    ]);
+  });
+
+  test("runs the platform binary when published under an npm scope", async () => {
+    // #given
+    const fixture = await createLazyCodexFixture({ packageName: "@code-yeongyu/lazycodex" });
+    const nodePath = Bun.which("node") ?? "node";
+
+    // #when
+    const result = spawnSync(nodePath, [fixture.lazycodexBin, "install", "--no-tui"], {
+      encoding: "utf8",
+      env: {
+        ...process.env,
+        CAPTURE_DIR: fixture.captureDir,
+        PATH: fixture.fakeBinDir,
+      },
+    });
+
+    // #then
+    expect(result.status).toBe(23);
+    expect((await readFile(join(fixture.captureDir, "env"), "utf8")).trim()).toBe("lazycodex");
+    expect(await canonicalizePackageRootCapture(fixture)).toBe(await realpath(fixture.root));
+    expect((await readFile(join(fixture.captureDir, "args"), "utf8")).trim().split("\n")).toEqual([
+      "install",
+      "--no-tui",
+    ]);
+  });
+
+  test("routes npm shim execution from the lazycodex package to the Codex installer", async () => {
+    // #given
+    const fixture = await createLazyCodexFixture({ wrapperFileName: "oh-my-opencode.js" });
+    const nodePath = Bun.which("node") ?? "node";
+
+    // #when
+    const result = spawnSync(nodePath, [fixture.wrapperBin, "install", "--no-tui"], {
+      encoding: "utf8",
+      env: {
+        ...process.env,
+        CAPTURE_DIR: fixture.captureDir,
+        PATH: fixture.fakeBinDir,
+      },
+    });
+
+    // #then
+    expect(result.status).toBe(23);
+    expect((await readFile(join(fixture.captureDir, "env"), "utf8")).trim()).toBe("lazycodex");
+    expect(await canonicalizePackageRootCapture(fixture)).toBe(await realpath(fixture.root));
+    expect((await readFile(join(fixture.captureDir, "args"), "utf8")).trim().split("\n")).toEqual([
+      "install",
+      "--no-tui",
+    ]);
+  });
+});
+
+async function createLazyCodexFixture(options: { packageName?: string; wrapperFileName?: string } = {}) {
+  const root = await mkdtemp(join(tmpdir(), "lazycodex-bin-wrapper-"));
+  testRoots.push(root);
+
+  const binDir = join(root, "bin");
+  const distCli = join(root, "dist", "cli", "index.js");
+  const fakeBinDir = join(root, "fake-bin");
+  const captureDir = join(root, "capture");
+  await mkdir(binDir, { recursive: true });
+  await mkdir(dirname(distCli), { recursive: true });
+  await mkdir(fakeBinDir, { recursive: true });
+  await mkdir(captureDir, { recursive: true });
+
+  const wrapperFileName = options.wrapperFileName ?? "lazycodex";
+  const wrapperBin = join(binDir, wrapperFileName);
+  await cp(fileURLToPath(new URL("./oh-my-opencode.js", import.meta.url)), wrapperBin);
+  if (wrapperFileName !== "lazycodex") {
+    await symlink(wrapperFileName, join(binDir, "lazycodex"));
+  }
+  await cp(fileURLToPath(new URL("./platform.js", import.meta.url)), join(binDir, "platform.js"));
+  await writeFile(join(root, "package.json"), JSON.stringify({ name: options.packageName ?? "lazycodex", type: "module" }));
+  await writeFile(distCli, "#!/usr/bin/env bun\n");
+  await writePlatformPackages(root);
+
+  const fakeBun = join(fakeBinDir, "bun");
+  await writeFile(
+    fakeBun,
+    [
+      "#!/bin/sh",
+      "printf '%s\\n' \"$OMO_INVOCATION_NAME\" > \"$CAPTURE_DIR/env\"",
+      "printf '%s\\n' \"$@\" > \"$CAPTURE_DIR/args\"",
+      "exit 23",
+      "",
+    ].join("\n"),
+  );
+  await chmod(fakeBun, 0o755);
+
+  return {
+    bundledCli: distCli,
+    captureDir,
+    fakeBinDir,
+    lazycodexBin: join(binDir, "lazycodex"),
+    root,
+    wrapperBin,
+  };
+}
+
+async function canonicalizePackageRootCapture(fixture: { readonly captureDir: string }): Promise<string> {
+  return realpath((await readFile(join(fixture.captureDir, "wrapper-root"), "utf8")).trim());
+}
+
+async function writePlatformPackages(root: string): Promise<void> {
+  const packages = getPlatformPackageCandidates({
+    platform: process.platform,
+    arch: process.arch,
+    libcFamily: process.platform === "linux" ? "glibc" : undefined,
+    packageBaseName: "oh-my-openagent",
+  });
+  for (const packageName of packages) {
+    const binaryPath = join(root, "node_modules", packageName, "bin", process.platform === "win32" ? "oh-my-opencode.exe" : "oh-my-opencode");
+    await mkdir(dirname(binaryPath), { recursive: true });
+    await writeFile(
+      binaryPath,
+      [
+        "#!/bin/sh",
+        "printf '%s\\n' \"$OMO_INVOCATION_NAME\" > \"$CAPTURE_DIR/env\"",
+        "printf '%s\\n' \"$OMO_WRAPPER_PACKAGE_ROOT\" > \"$CAPTURE_DIR/wrapper-root\"",
+        "printf '%s\\n' \"$@\" > \"$CAPTURE_DIR/args\"",
+        "exit 23",
+        "",
+      ].join("\n"),
+    );
+    await chmod(binaryPath, 0o755);
+  }
+
+  if (process.platform === "linux") {
+    const detectLibcPath = join(root, "node_modules", "detect-libc", "index.js");
+    await mkdir(dirname(detectLibcPath), { recursive: true });
+    await writeFile(detectLibcPath, 'exports.familySync = () => "glibc";\n');
+  }
+}

package/bin/platform.d.ts

@@ -2,6 +2,7 @@ export declare function getPlatformPackage(options: {
   platform: string;
   arch: string;
   libcFamily?: string | null;
+  packageBaseName?: string;
 }): string;
 
 export declare function getPlatformPackageCandidates(options: {
@@ -9,6 +10,11 @@ export declare function getPlatformPackageCandidates(options: {
   arch: string;
   libcFamily?: string | null;
   preferBaseline?: boolean;
+  packageBaseName?: string;
 }): string[];
 
 export declare function getBinaryPath(pkg: string, platform: string): string;
+
+export declare function getPackageBareName(packageName: string): string;
+
+export declare function resolvePlatformPackageBaseName(wrapperPackageName: string): string;

package/bin/platform.js

@@ -1,6 +1,25 @@
 // bin/platform.js
 // Shared platform detection module - used by wrapper and postinstall
 
+const PLATFORM_PACKAGE_BASE_BY_WRAPPER_NAME = {
+  lazycodex: "oh-my-openagent",
+};
+
+export function getPackageBareName(packageName) {
+  return packageName.split("/").pop() || packageName;
+}
+
+/**
+ * Resolve platform package base from a wrapper package name.
+ * Wrapper aliases can intentionally reuse an existing platform package family.
+ * @param {string} wrapperPackageName
+ * @returns {string}
+ */
+export function resolvePlatformPackageBaseName(wrapperPackageName) {
+  const bareName = getPackageBareName(wrapperPackageName);
+  return PLATFORM_PACKAGE_BASE_BY_WRAPPER_NAME[bareName] ?? wrapperPackageName;
+}
+
 /**
  * Get the platform-specific package name
  * @param {{ platform: string, arch: string, libcFamily?: string | null, packageBaseName?: string }} options

package/bin/platform.test.ts

@@ -1,6 +1,71 @@
 // bin/platform.test.ts
 import { describe, expect, test } from "bun:test";
-import { getBinaryPath, getPlatformPackage, getPlatformPackageCandidates } from "./platform.js";
+import {
+  getBinaryPath,
+  getPackageBareName,
+  getPlatformPackage,
+  getPlatformPackageCandidates,
+  resolvePlatformPackageBaseName,
+} from "./platform.js";
+
+describe("getPackageBareName", () => {
+  test("strips npm scope from package name", () => {
+    // #given
+    const packageName = "@code-yeongyu/lazycodex";
+
+    // #when
+    const bareName = getPackageBareName(packageName);
+
+    // #then
+    expect(bareName).toBe("lazycodex");
+  });
+});
+
+describe("resolvePlatformPackageBaseName", () => {
+  test("maps lazycodex wrapper to oh-my-openagent platform package family", () => {
+    // #given
+    const wrapperPackageName = "lazycodex";
+
+    // #when
+    const resolvedPlatformBase = resolvePlatformPackageBaseName(wrapperPackageName);
+
+    // #then
+    expect(resolvedPlatformBase).toBe("oh-my-openagent");
+  });
+
+  test("maps scoped lazycodex wrapper to oh-my-openagent platform package family", () => {
+    // #given
+    const wrapperPackageName = "@code-yeongyu/lazycodex";
+
+    // #when
+    const resolvedPlatformBase = resolvePlatformPackageBaseName(wrapperPackageName);
+
+    // #then
+    expect(resolvedPlatformBase).toBe("oh-my-openagent");
+  });
+
+  test("keeps oh-my-opencode wrapper mapped to oh-my-opencode platform package family", () => {
+    // #given
+    const wrapperPackageName = "oh-my-opencode";
+
+    // #when
+    const resolvedPlatformBase = resolvePlatformPackageBaseName(wrapperPackageName);
+
+    // #then
+    expect(resolvedPlatformBase).toBe("oh-my-opencode");
+  });
+
+  test("keeps oh-my-openagent wrapper mapped to oh-my-openagent platform package family", () => {
+    // #given
+    const wrapperPackageName = "oh-my-openagent";
+
+    // #when
+    const resolvedPlatformBase = resolvePlatformPackageBaseName(wrapperPackageName);
+
+    // #then
+    expect(resolvedPlatformBase).toBe("oh-my-openagent");
+  });
+});
 
 describe("getPlatformPackage", () => {
   // #region Darwin platforms

package/dist/cli/cli-program.d.ts

@@ -1 +1,19 @@
+import type { InstallArgs } from "./types";
+type InstallCommandOptions = {
+    readonly tui?: boolean;
+    readonly claude?: InstallArgs["claude"];
+    readonly openai?: InstallArgs["openai"];
+    readonly gemini?: InstallArgs["gemini"];
+    readonly copilot?: InstallArgs["copilot"];
+    readonly platform?: InstallArgs["platform"];
+    readonly opencodeZen?: InstallArgs["opencodeZen"];
+    readonly zaiCodingPlan?: InstallArgs["zaiCodingPlan"];
+    readonly kimiForCoding?: InstallArgs["kimiForCoding"];
+    readonly opencodeGo?: InstallArgs["opencodeGo"];
+    readonly vercelAiGateway?: InstallArgs["vercelAiGateway"];
+    readonly codexAutonomous?: InstallArgs["codexAutonomous"];
+    readonly skipAuth?: boolean;
+};
+export declare function resolveInstallArgs(options: InstallCommandOptions, invocationName?: string | undefined): InstallArgs;
 export declare function runCli(): void;
+export {};