oh-my-opencode 4.6.0 → 4.7.1

package/packages/omo-codex/scripts/install-local-entrypoint.test.mjs

@@ -57,14 +57,14 @@ test("#given lazycodex runs through an npm bin symlink #when running the Node in
 	}
 });
 
-test("#given dry-run install flags #when running the Node installer entrypoint #then prints delegated codex install command", () => {
+test("#given dry-run install flags #when running the Node installer entrypoint #then prints delegated autonomous codex install command", () => {
 	// given
 	const scriptPath = fileURLToPath(new URL("./install-local.mjs", import.meta.url));
 
 	// when
 	const output = execFileSync(
 		process.execPath,
-		[scriptPath, "--dry-run", "install", "--no-tui", "--codex-autonomous"],
+		[scriptPath, "--dry-run", "install", "--no-tui"],
 		{ encoding: "utf8" },
 	).trim();
 
@@ -72,6 +72,21 @@ test("#given dry-run install flags #when running the Node installer entrypoint #
 	assert.equal(output, "npx --yes --package oh-my-openagent omo install --platform=codex --no-tui --codex-autonomous");
 });
 
+test("#given dry-run install opt-out #when running the Node installer entrypoint #then preserves existing Codex permission settings", () => {
+	// given
+	const scriptPath = fileURLToPath(new URL("./install-local.mjs", import.meta.url));
+
+	// when
+	const output = execFileSync(
+		process.execPath,
+		[scriptPath, "--dry-run", "install", "--no-tui", "--no-codex-autonomous"],
+		{ encoding: "utf8" },
+	).trim();
+
+	// then
+	assert.equal(output, "npx --yes --package oh-my-openagent omo install --platform=codex --no-tui --no-codex-autonomous");
+});
+
 test("#given dry-run doctor #when running the Node installer entrypoint #then prints delegated doctor command", () => {
 	// given
 	const scriptPath = fileURLToPath(new URL("./install-local.mjs", import.meta.url));
@@ -100,6 +115,19 @@ test("#given dry-run cleanup #when running the Node installer entrypoint #then p
 	assert.equal(output, "npx --yes --package oh-my-openagent omo cleanup --platform=codex --project /tmp/lazycodex-qa");
 });
 
+test("#given dry-run ulw-loop #when running the Node installer entrypoint #then prints delegated ulw-loop command", () => {
+	// given
+	const scriptPath = fileURLToPath(new URL("./install-local.mjs", import.meta.url));
+
+	// when
+	const output = execFileSync(process.execPath, [scriptPath, "--dry-run", "ulw-loop", "help"], {
+		encoding: "utf8",
+	}).trim();
+
+	// then
+	assert.equal(output, "npx --yes --package oh-my-openagent omo ulw-loop help");
+});
+
 test("#given the invoking argv path disappears #when importing the Node installer module #then the entrypoint guard does not throw", () => {
 	// given
 	const scriptPath = fileURLToPath(new URL("./install-local.mjs", import.meta.url));

package/packages/omo-codex/scripts/install-local.mjs

@@ -147,7 +147,7 @@ export async function installMarketplaceLocally(options = {}) {
 		platform,
 		trustedHookStates,
 		agentConfigs: [...agentConfigs.values()].sort((left, right) => left.name.localeCompare(right.name)),
-		autonomousPermissions: options.autonomousPermissions === true,
+		autonomousPermissions: options.autonomousPermissions !== false,
 	});
 	const projectCleanup = await repairProjectLocalCodexArtifactsBestEffort({ startDirectory: projectDirectory, codexHome, log });
 	for (const configCleanup of projectCleanup.configs) {

package/packages/omo-codex/scripts/install-local.test.mjs

@@ -219,7 +219,9 @@ test("#given local marketplace #when installing #then copies versioned plugins a
 	);
 
 	const config = await readFile(join(codexHome, "config.toml"), "utf8");
-	assert.match(config, /\[features\]\n(?:plugin_hooks = true\n)?plugins = true/);
+	assert.match(config, /\[features\]/);
+	assert.match(config, /plugins = true/);
+	assert.match(config, /plugin_hooks = true/);
 	assert.match(config, /\[marketplaces\.debug-marketplace\]/);
 	assert.match(config, /source_type = "local"/);
 	assert.match(config, /\[plugins\."alpha@debug-marketplace"\]\nenabled = true/);

package/packages/shared-skills/skills/lcx-report-bug/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: lcx-report-bug
+description: "Create a high-signal LazyCodex bug report for code-yeongyu/lazycodex. Use this whenever the user asks to report, file, open, or triage a LazyCodex, lazycodex-ai, omo-codex, or Codex plugin bug, especially when they need root cause, reproduction steps, expected fix guidance, and a GitHub issue."
+metadata:
+  short-description: Report LazyCodex bugs with debugging evidence
+---
+
+# lcx-report-bug
+
+You are a LazyCodex bug reporter. Produce one useful GitHub issue in English for `code-yeongyu/lazycodex`, backed by runtime evidence rather than guesses.
+
+Use GPT-5.5 style: outcome first, concise, evidence-bound. Keep the workflow moving, but do not file an issue until the root cause and reproduction path are concrete enough for a maintainer to act.
+
+## Goal
+
+Create or prepare a GitHub issue that includes:
+
+- clear title
+- environment
+- reproducible steps
+- expected behavior
+- actual behavior
+- confirmed or strongly evidenced root cause
+- fix approach, including files or components likely involved
+- verification plan
+
+## Required Workflow
+
+1. Read the user's bug report and identify the affected surface: LazyCodex installer, Codex plugin, skill, hook, MCP, CLI alias, GitHub marketplace sync, or web/docs.
+2. Invoke `$omo:debugging` for the investigation. If Codex exposes only unqualified skill names in the current session, invoke `$debugging` and state that it is the OMO debugging skill.
+3. Follow the debugging skill far enough to gather runtime evidence:
+   - form at least three plausible hypotheses
+   - run the smallest reproduction that exercises the real surface
+   - confirm the root cause by observing the failing state
+   - identify the minimal fix path or maintainer action
+4. Search for an existing issue before creating a new one:
+
+```bash
+gh issue list --repo code-yeongyu/lazycodex --search "<short error or symptom>" --state open
+```
+
+5. If a matching open issue exists, add a comment with the new evidence instead of creating a duplicate.
+6. If no matching issue exists, create the issue with `gh`.
+
+## Issue Body Template
+
+Write the issue body in English and keep it direct:
+
+```markdown
+## Summary
+[One or two sentences describing the user-visible failure.]
+
+## Environment
+- LazyCodex version:
+- Codex version:
+- OS:
+- Install method:
+- Relevant config:
+
+## Reproduction
+1. [Exact command or UI action]
+2. [Exact next step]
+3. [Observed failure trigger]
+
+## Expected Behavior
+[What should have happened.]
+
+## Actual Behavior
+[What happened instead, including exact error text or output.]
+
+## Evidence
+[Commands, logs, screenshots, traces, or links used to confirm the failure.]
+
+## Root Cause
+[Confirmed cause. If not fully confirmed, say what evidence supports it and what remains uncertain.]
+
+## Proposed Fix
+[Concrete implementation or operational fix. Include likely files, components, or commands.]
+
+## Verification Plan
+- [Check that reproduces the original failure]
+- [Check that proves the fix]
+- [Regression check for adjacent LazyCodex/Codex plugin behavior]
+```
+
+## GitHub Creation Path
+
+Prefer `gh`:
+
+```bash
+ISSUE_BODY="/tmp/lcx-report-bug-$(date +%Y%m%d-%H%M%S).md"
+$EDITOR "$ISSUE_BODY"
+gh issue create --repo code-yeongyu/lazycodex --title "<clear title>" --body-file "$ISSUE_BODY"
+```
+
+If `$EDITOR` is not usable, write the file with the available file-editing tool, then run the same `gh issue create` command.
+
+After creating or commenting, return the issue URL and a short summary of the evidence used.
+
+## Browser use fallback
+
+If `gh` is unavailable, unauthenticated, or blocked, use Browser Use against the real GitHub page:
+
+1. Open `https://github.com/code-yeongyu/lazycodex/issues/new`.
+2. Fill the title and body from the template.
+3. Submit the issue only after visually confirming the repo, title, and body.
+4. Capture the resulting issue URL.
+
+## Computer use fallback
+
+If Browser Use is unavailable but a desktop browser is open and authenticated, use Computer Use:
+
+1. Navigate to `https://github.com/code-yeongyu/lazycodex/issues/new`.
+2. Fill the title and body.
+3. Verify the target repository and final text before submission.
+4. Submit and capture the issue URL.
+
+## Stop Conditions
+
+Stop and ask one narrow question only when the missing fact changes the issue materially, such as the affected version, a private log the agent cannot access, or whether the user wants a duplicate filed despite an existing matching issue.
+
+Do not file:
+
+- a vague issue without reproduction steps
+- an issue that claims a root cause not supported by runtime evidence
+- a duplicate when commenting on an existing issue is enough
+- a fix PR unless the user separately asks for one

package/packages/shared-skills/skills/lcx-report-bug/agents/openai.yaml

@@ -0,0 +1,9 @@
+interface:
+  display_name: "lcx-report-bug (omo)"
+  short_description: "Report LazyCodex bugs with debugging evidence"
+  search_terms:
+    - "lcx-report-bug"
+    - "lazycodex bug"
+    - "lazycodex issue"
+    - "omo-codex bug"
+  default_prompt: "Use $lcx-report-bug to investigate this LazyCodex bug and file a clear issue with reproduction, root cause, and fix guidance."

package/packages/shared-skills/skills/review-work/SKILL.md

@@ -8,15 +8,15 @@ This skill may include examples copied from the OpenCode harness. In Codex, do n
 
 | OpenCode example | Codex tool to use |
 | --- | --- |
-| `call_omo_agent(subagent_type="explore", ...)` | `spawn_agent(agent_type="explorer", task_name="...", message="...")` |
-| `call_omo_agent(subagent_type="librarian", ...)` | `spawn_agent(agent_type="librarian", task_name="...", message="...")` |
-| `task(subagent_type="plan", ...)` | `spawn_agent(agent_type="plan", task_name="...", message="...")` |
-| `task(subagent_type="oracle", ...)` for final verification | `spawn_agent(agent_type="codex-ultrawork-reviewer", task_name="...", message="...")` |
-| `task(category="...", ...)` for implementation or QA | `spawn_agent(agent_type="worker", task_name="...", message="...")` |
+| `call_omo_agent(subagent_type="explore", ...)` | `spawn_agent(agent_type="explorer", task_name="...", message="...", fork_turns="none")` |
+| `call_omo_agent(subagent_type="librarian", ...)` | `spawn_agent(agent_type="librarian", task_name="...", message="...", fork_turns="none")` |
+| `task(subagent_type="plan", ...)` | `spawn_agent(agent_type="plan", task_name="...", message="...", fork_turns="none")` |
+| `task(subagent_type="oracle", ...)` for final verification | `spawn_agent(agent_type="codex-ultrawork-reviewer", task_name="...", message="...", fork_turns="none")` |
+| `task(category="...", ...)` for implementation or QA | `spawn_agent(agent_type="worker", task_name="...", message="...", fork_turns="none")` |
 | `background_output(task_id="...")` | `wait_agent(...)` to wait for subagent completion and mailbox updates |
 | `team_*(...)` | Use Codex native subagents plus `send_message`, `followup_task`, `wait_agent`, and `close_agent` |
 
-When translating `load_skills=[...]`, include the requested skill names in the spawned agent's `message`. If a code block below conflicts with this section, this section wins.
+Codex full-history forks inherit the parent agent type, model, and reasoning effort, so role-specific spawns with `agent_type` must use a non-full-history fork mode such as `fork_turns="none"`. Include any required conversation context, files, diffs, constraints, and requested skill names directly in the spawned agent's `message`. If a code block below conflicts with this section, this section wins.
 
 ## Codex Subagent Reliability
 
@@ -28,7 +28,7 @@ handoff. Role selection requires `agent_type`; `model` +
 worker. Prefer `fork_turns: "none"` unless full history is truly
 required; paste only the review context that worker needs.
 
-Plan and reviewer agents may run for a long time; spawn them in the background, keep doing independent root work, and poll with short wait_agent cycles. Never use a single long blocking wait for them.
+Plan and reviewer agents may run for a long time; spawn them in the background, keep doing independent root work, and poll with short wait_agent cycles. Never use a single long blocking wait for them. While any child is active, keep the parent visibly alive with brief status updates that include active subagent count, agent names, last heartbeat, and whether the parent is waiting for mailbox updates.
 
 Use `wait_agent` for completion signals, but treat `wait_agent` as a
 mailbox signal, not proof of completion, content, or errors. After two

package/packages/shared-skills/skills/start-work/SKILL.md

@@ -9,11 +9,11 @@ This skill ports the OpenCode `/start-work` flow onto Codex. Any OpenCode-only t
 
 | OpenCode example | Codex tool to use |
 | --- | --- |
-| `task(subagent_type="explore", ...)` | `spawn_agent(agent_type="explorer", task_name="...", message="...")` |
-| `task(subagent_type="librarian", ...)` | `spawn_agent(agent_type="librarian", task_name="...", message="...")` |
-| `task(subagent_type="plan", ...)` | `spawn_agent(agent_type="plan", task_name="...", message="...")` |
-| `task(subagent_type="oracle", ...)` for final verification | `spawn_agent(agent_type="codex-ultrawork-reviewer", task_name="...", message="...")` |
-| `task(category="...", ...)` for implementation or QA | `spawn_agent(agent_type="worker", task_name="...", message="...")` |
+| `task(subagent_type="explore", ...)` | `spawn_agent(agent_type="explorer", task_name="...", message="...", fork_turns="none")` |
+| `task(subagent_type="librarian", ...)` | `spawn_agent(agent_type="librarian", task_name="...", message="...", fork_turns="none")` |
+| `task(subagent_type="plan", ...)` | `spawn_agent(agent_type="plan", task_name="...", message="...", fork_turns="none")` |
+| `task(subagent_type="oracle", ...)` for final verification | `spawn_agent(agent_type="codex-ultrawork-reviewer", task_name="...", message="...", fork_turns="none")` |
+| `task(category="...", ...)` for implementation or QA | `spawn_agent(agent_type="worker", task_name="...", message="...", fork_turns="none")` |
 | `background_output(task_id="...")` | `wait_agent(...)` |
 | `dispatchInternalPrompt(...)` | the `Stop` hook emits `{"decision":"block","reason":"<prompt>"}` automatically; see Continuation |
 | `team_*(...)` | `spawn_agent` + `send_message` + `followup_task` + `wait_agent` + `close_agent` |
@@ -30,7 +30,7 @@ handoff. Role selection requires `agent_type`; `model` +
 worker. Prefer `fork_turns: "none"` unless full history is truly
 required; paste only the context the child needs.
 
-Plan and reviewer agents may run for a long time; spawn them in the background, keep doing independent root work, and poll with short wait_agent cycles. Never use a single long blocking wait for them.
+Plan and reviewer agents may run for a long time; spawn them in the background, keep doing independent root work, and poll with short wait_agent cycles. Never use a single long blocking wait for them. While any child is active, keep the parent visibly alive with brief status updates that include active subagent count, agent names, last heartbeat, and whether the parent is waiting for mailbox updates.
 
 Use `wait_agent` for completion signals, but treat `wait_agent` as a
 mailbox signal, not proof of completion, content, or errors. After two

package/packages/shared-skills/skills/ulw-plan/SKILL.md

@@ -10,7 +10,7 @@ Named after the Titan who brought fire to humanity, you bring foresight and stru
 **YOU ARE A PLANNER. NOT AN IMPLEMENTER. NOT A CODE WRITER.**
 
 When user says "do X", "fix X", "build X" - interpret as "create a work plan for X". No exceptions.
-Your only outputs: questions, research, work plans (`plans/<slug>.md`), drafts (`.omo/drafts/*.md`).
+Your only outputs: questions, research, work plans (`.omo/plans/<slug>.md`), drafts (`.omo/drafts/*.md`).
 </identity>
 
 <mission>
@@ -52,7 +52,7 @@ This is your north star quality metric.
 - Spawning read-only subagents for research
 
 ### Allowed (plan artifacts only)
-- Writing/editing files in `plans/<slug>.md`
+- Writing/editing files in `.omo/plans/<slug>.md`
 - Writing/editing files in `.omo/drafts/*.md`
 
 ### Forbidden (mutating, plan-executing)
@@ -169,7 +169,7 @@ ANY NO -> Ask the specific unclear question.
 Spawn the metis agent to analyze the planning session for contradictions, ambiguity, missing constraints, and execution risks:
 
 ```
-spawn_agent(agent_type="metis", task_name="gap-analysis",
+spawn_agent(agent_type="metis", task_name="gap-analysis", fork_turns="none",
   message="Review this planning session. Goal: {summary}. Discussed: {key points}. Understanding: {interpretation}. Research: {findings}. Identify: contradictions, ambiguity, missing constraints, execution risks, scope creep areas, missing acceptance criteria.")
 ```
 
@@ -217,7 +217,7 @@ Self-review checklist:
 **Defaults Applied**: [default]: [assumption]
 **Decisions Needed**: [question requiring user input] (if any)
 
-Plan saved to: plans/{slug}.md
+Plan saved to: .omo/plans/{slug}.md
 ```
 
 If "Decisions Needed" exists, wait for user response and update plan.
@@ -237,8 +237,8 @@ Only activated when user selects "High Accuracy Review".
 Spawn the momus agent with the plan file path:
 
 ```
-spawn_agent(agent_type="momus", task_name="plan-review",
-  message="Review this plan: plans/{slug}.md")
+spawn_agent(agent_type="momus", task_name="plan-review", fork_turns="none",
+  message="Review this plan: .omo/plans/{slug}.md")
 ```
 
 Handle the three-verdict response:
@@ -254,13 +254,13 @@ Handle the three-verdict response:
 
 After plan is complete (direct or Momus-approved):
 1. Delete draft: remove `.omo/drafts/{name}.md`
-2. Guide user: "Plan saved to `plans/{slug}.md`. Spawn a worker agent to begin execution."
+2. Guide user: "Plan saved to `.omo/plans/{slug}.md`. Spawn a worker agent to begin execution."
 </phases>
 
 <plan_template>
 ## Plan Structure
 
-Generate to: `plans/{slug}.md`
+Generate to: `.omo/plans/{slug}.md`
 
 **Single Plan Mandate**: No matter how large the task, EVERYTHING goes into ONE plan. Never split into "Phase 1, Phase 2". 50+ TODOs is fine.
 
@@ -292,7 +292,7 @@ Generate to: `plans/{slug}.md`
 > ZERO HUMAN INTERVENTION - all verification is agent-executed.
 - Test decision: [TDD / tests-after / none] + framework
 - QA policy: Every task has agent-executed scenarios
-- Evidence: evidence/task-{N}-{slug}.{ext}
+- Evidence: .omo/evidence/task-{N}-{slug}.{ext}
 
 ## Execution Strategy
 ### Parallel Execution Waves
@@ -330,13 +330,13 @@ Wave 2: [dependent tasks]
     Tool: [bash / curl / tmux / playwright]
     Steps: [exact actions with specific data]
     Expected: [concrete, binary pass/fail]
-    Evidence: evidence/task-{N}-{slug}.{ext}
+    Evidence: .omo/evidence/task-{N}-{slug}.{ext}
 
   Scenario: [Failure/edge case]
     Tool: [same]
     Steps: [trigger error condition]
     Expected: [graceful failure with correct error message/code]
-    Evidence: evidence/task-{N}-{slug}-error.{ext}
+    Evidence: .omo/evidence/task-{N}-{slug}-error.{ext}
   ```
 
   **Commit**: YES/NO | Message: `type(scope): desc` | Files: [paths]

package/postinstall.mjs

@@ -8,6 +8,7 @@ import {
   getBinaryPath,
   resolvePlatformPackageBaseName,
 } from "./bin/platform.js";
+import { detectPlatformBinaryMismatch } from "./bin/version-mismatch.js";
 
 const require = createRequire(import.meta.url);
 
@@ -81,12 +82,31 @@ function getLibcFamily() {
   }
 }
 
+function readMainPackageJson() {
+  try {
+    return JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
+  } catch {
+    return null;
+  }
+}
+
 function getPackageBaseName() {
+  const packageJson = readMainPackageJson();
+  return resolvePlatformPackageBaseName(packageJson?.name || "oh-my-opencode");
+}
+
+function getMainPackageVersion() {
+  const packageJson = readMainPackageJson();
+  return packageJson?.version ?? null;
+}
+
+function readPlatformPackageVersion(pkg) {
   try {
-    const packageJson = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8"));
-    return resolvePlatformPackageBaseName(packageJson.name || "oh-my-opencode");
+    const platformPackageJsonPath = require.resolve(`${pkg}/package.json`);
+    const packageJson = JSON.parse(readFileSync(platformPackageJsonPath, "utf8"));
+    return packageJson.version ?? null;
   } catch {
-    return "oh-my-opencode";
+    return null;
   }
 }
 
@@ -126,6 +146,19 @@ function main() {
       );
     }
 
+    const mismatch = detectPlatformBinaryMismatch({
+      mainVersion: getMainPackageVersion(),
+      platformVersion: readPlatformPackageVersion(resolvedPackage),
+      platformPackage: resolvedPackage,
+    });
+    if (mismatch) {
+      console.warn(`⚠ oh-my-opencode platform binary version mismatch detected`);
+      console.warn(`  ${packageBaseName}: ${mismatch.mainVersion}`);
+      console.warn(`  ${mismatch.platformPackage}: ${mismatch.platformVersion}`);
+      console.warn(`  The startup banner may show the stale version until the platform binary is updated.`);
+      console.warn(`  Fix: npm install -g ${packageBaseName}@${mismatch.mainVersion} ${mismatch.platformPackage}@${mismatch.mainVersion}`);
+    }
+
     console.log(`✓ oh-my-opencode binary installed for ${platform}-${arch} (${resolvedPackage})`);
   } catch (error) {
     console.warn(`⚠ oh-my-opencode: ${error.message}`);

package/dist/cli/install-codex/codex-config-mcp.d.ts

@@ -1 +0,0 @@
-export declare function ensureContext7McpServer(config: string): string;