oh-my-customcodex 0.5.1 → 0.5.3

package/templates/guides/claude-code/15-version-compatibility.md

@@ -2,6 +2,113 @@
 
 This guide records Claude Code release-note impact that affects the Claude compatibility template. The Codex-native runtime still uses `.codex/**` and OMX as the primary surface.
 
+## v2.1.150
+
+Published: 2026-05-23.
+
+Source: upstream oh-my-customcode #1220, Codex port #1380.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| Internal infrastructure improvements only | No user-facing Claude compatibility behavior changed for templates, agents, skills, hooks, or rules. | No package change. Record the no-op review so release-monitor ports can be closed with evidence instead of staying open. |
+
+## v2.1.149
+
+Published: 2026-05-22.
+
+Source: upstream oh-my-customcode #1219, Codex port #1379.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| `/usage` now breaks limit usage down by skills, subagents, plugins, and MCP servers | Useful diagnostic vocabulary for Claude compatibility sessions; Codex-native reporting still comes from OMX status, trace, and local CLI surfaces. | No runtime change. Keep cost and status reports source-specific instead of treating Claude `/usage` output as Codex evidence. |
+| `/diff` detail view supports keyboard scrolling and Markdown renders GFM task-list checkboxes | Improves Claude terminal UX for reviews and release notes. | No template change. Continue writing normal Markdown task lists; Claude now renders them more faithfully. |
+| Enterprise `allowAllClaudeAiMcps` can load claude.ai cloud MCP connectors next to managed MCP config | Only affects managed Claude enterprise workspaces. | Document as Claude-template compatibility only; Codex MCP routing remains configured through Codex/OMX config. |
+| PowerShell `cd` aliases, wildcard prefix rules, and stale directory-variable tracking were hardened | Permission-analysis fixes reduce Claude compatibility sandbox escapes. | No Codex shell-policy change. Do not copy PowerShell-specific assumptions into Codex Bash approvals. |
+| Git worktree sandbox allowlists now cover only the shared `.git` directory, not the whole main repo | Aligns with this repo's preference for isolated worktrees during auto-dev sweeps. | Keep release and issue-sweep work in clean worktrees and verify dirty-tree boundaries explicitly. |
+| Bash `find` no longer exhausts macOS file/vnode tables on large trees | Large repository scans are safer for Claude compatibility sessions. | Still prefer `rg`/targeted `find` in Codex sessions and keep scans bounded. |
+| `/ultraplan` and remote sessions no longer fail when there are no real uncommitted changes | Reduces false blockers for clean-tree planning. | No package change; continue verifying `git status` before declaring clean boundaries. |
+| `otelHeadersHelper` reports path-with-spaces failures in `/doctor` and debug logs | Helps diagnose local telemetry setup drift. | Keep hook and doctor guidance path-safe, especially under workspace paths that may contain spaces. |
+
+## v2.1.148
+
+Published: 2026-05-22.
+
+Source: upstream oh-my-customcode #1218, Codex port #1378.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| Fixed a v2.1.147 regression where the Bash tool returned exit code 127 for every command for some users | Claude compatibility sessions on affected versions may have produced false command-not-found failures. | Treat suspicious all-command `127` reports from Claude v2.1.147 as environment/version evidence to verify before changing repo code. No Codex runtime change. |
+
+## v2.1.147
+
+Published: 2026-05-21.
+
+Source: upstream oh-my-customcode #1216 and #1222, Codex ports #1376 and #1381.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| Added the `Workflow` tool for deterministic multi-agent orchestration, gated by `CLAUDE_CODE_WORKFLOWS=1` | This overlaps conceptually with OMX `$pipeline`, but it is a Claude-native tool surface. | Do not replace Codex/OMX pipeline routing with Claude Workflow. Mention the env gate when documenting Claude-template sessions. |
+| Pinned background sessions stay alive when idle, restart in place for updates, and are shed after non-pinned sessions under memory pressure | Claude compatibility background agents are more durable. | Keep Codex-native child-agent and OMX session lifecycle separate; pinned Claude sessions are not proof of active OMX work. |
+| `/simplify` was renamed to `/code-review`; it now reports correctness bugs at chosen effort levels and the old cleanup-and-fix behavior was removed | Potential naming confusion with this package's `dev-review` and `dev-refactor` skills. | Keep package commands as `dev-review` for best-practice review and `dev-refactor` for cleanup/refactor. Do not add a dead `simplify` route. |
+| REPL and Workflow sandboxes were hardened against prototype-pollution and thenable-based escapes | Security hardening applies to Claude runtime internals. | No package code change; keep security reviews focused on repo-owned hooks, scripts, and generated templates. |
+| Auto-updater retries transient network failures and reports specific error categories plus current version on update failure | Helps distinguish transient update problems from package regressions. | For publish/update triage, verify registry token, workflow logs, and current version before making permanent workflow edits. |
+| Large diff rendering and prompt-history duplicate handling improved | UX-only for Claude compatibility sessions. | No template change. |
+| Enterprise login restrictions are enforced against third-party-provider and API-key sessions | Managed Claude environments behave more consistently. | No Codex auth change. Treat enterprise login policy as external environment state. |
+| Headless/SDK unknown slash commands now show an error instead of silently doing nothing | Broken generated commands should be easier to detect. | Keep template command names explicit and test packaged command references. |
+| Plugin agents declaring multiple `Agent(...)` tool types no longer drop all but the last one | Compatibility templates with multi-agent tool declarations are safer. | Continue using canonical, explicit agent names in package docs and frontmatter. |
+| Hook `if` conditions such as `PowerShell(git push*)` were fixed to match as intended | Claude hook compatibility improved. | Keep Codex hook routing Bash-first unless a hook is explicitly PowerShell-specific. |
+
+## v2.1.146
+
+Published: 2026-05-21.
+
+Source: upstream oh-my-customcode #1205, Codex port #1364.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| `/simplify` was renamed to `/code-review` and accepts effort levels such as `/code-review high` | Native Claude command naming is now closer to review workflows, but this package still exposes its own `dev-review` skill. | No runtime rename. Keep user-facing docs clear that `dev-review` is the package skill and `/code-review` is the native Claude command. |
+| Auto mode no longer suppresses `AskUserQuestion` when the user or a skill explicitly relies on it | Ambiguity-gated compatibility workflows can ask explicit questions even in auto mode. | No Codex tool change. Keep `request_user_input`/question usage limited to genuinely branching cases. |
+| MCP `resources/list`, `resources/templates/list`, and `prompts/list` pagination was fixed | Large memory or ontology MCP servers are less likely to hide resources after page 1. | No package change; treat complete paginated MCP lists as more reliable evidence. |
+| `CLAUDE_CODE_SUBAGENT_MODEL` is forwarded to child processes in multi-agent sessions | Claude compatibility sessions with model env overrides now preserve child-process model intent. | No Codex model override. Codex-native child agents still follow repo model routing and inherited defaults. |
+| `/background` accepts skill-only or custom-slash-only input and background sessions preserve granted tool permissions | Long-running Claude compatibility sessions are less likely to stall on already granted permissions. | No Codex change. Keep permission expectations explicit in workflow prompts. |
+| Agent SDK streaming end-of-session exception was fixed | Agent SDK plugin experiments should be less noisy at stream completion. | Monitor only; no package change. |
+
+## v2.1.145
+
+Published: 2026-05-19.
+
+Source: upstream oh-my-customcode #1191, Codex port #1353.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| Statusline input includes structured GitHub fields such as `gh.repo`, `gh.pr_number`, and `gh.pr_state` | Removes the need to call `gh pr view` on every refresh when Claude compatibility statusline JSON already carries PR context. | Ported. `statusline.sh` now prefers native `gh.*` fields and falls back to the cached `gh pr view` path only when they are absent. |
+| Additional statusline fields may be empty strings | Empty fields can collapse TSV parsing if not normalized. | Ported. Empty native GitHub fields are normalized before Bash reads them. |
+| Stability fixes for statusline and background sessions are additive | No Codex runtime change beyond template compatibility. | Keep `.codex/**` behavior primary and mirror compatibility docs. |
+
+## v2.1.144
+
+Published: 2026-05-18.
+
+Source: upstream oh-my-customcode #1187, Codex port #1349.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| `claude agents --json` exposes structured background-agent state | Claude compatibility statusline and monitoring can show active agent counts without parsing display text. | Ported. Statusline JSON `agents` arrays render as `A:N` when active agents exist. |
+| Stop/SubagentStop input can include `background_tasks` and `session_crons` | Session-end hooks can detect dangling background work and cron state. | Ported. `session-reflection.sh` records counts and summaries when those fields are present. |
+| Background-agent status handling became more reliable | Reduces false stale-agent diagnostics for Claude compatibility users. | Keep existing Codex/OMX agent tracking and treat Claude JSON as optional compatibility evidence. |
+
+## v2.1.143
+
+Published: 2026-05-17.
+
+Source: upstream oh-my-customcode #1166, Codex port #1348.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| Hook/session lifecycle payloads became richer for background work | The compatibility template can capture more useful session-end evidence without blocking shutdown. | Ported through the advisory `session-reflection.sh` Stop/SubagentStop hook. |
+| Background session handling received additional fixes | Helps Claude compatibility workflows that run long-lived agents. | No Codex runtime change; document behavior and keep OMX-native orchestration as primary. |
+| Release-note changes are Claude-template oriented | The package must avoid redesigning Codex-native flow for Claude-only payload additions. | Mirror the compatibility guide and add tests that lock template/source docs together. |
+
 ## v2.1.142
 
 Published: 2026-05-14.

package/templates/guides/claude-code-tracking.md

@@ -0,0 +1,51 @@
+# Background Agent Progress Tracking
+
+This is the Codex/OMX replacement for the old Claude Code background-agent tracking pattern. Use it when a subagent, team member, or delegated task keeps running while the main conversation moves on.
+
+## What To Track
+
+| Field | Purpose | Suggested source |
+| --- | --- | --- |
+| `agent_id` | Identify the worker unambiguously | Team member label or agent name |
+| `task` | Record what the worker is doing | The delegated prompt or issue title |
+| `state` | Show the current lifecycle stage | `queued`, `running`, `blocked`, `done`, `cleaned` |
+| `last_update` | Detect stale work | Timestamp from the latest status write |
+| `owner` | Tie progress to the current session | Branch, run, or team lead |
+| `next_action` | Make the next step obvious | `wait`, `retry`, `cleanup`, or `handoff` |
+
+## Preferred Surfaces
+
+- `.omx/state/` for durable session state.
+- `.omx/notepad.md` for lightweight progress notes.
+- `.omx/logs/` for execution traces and failure evidence.
+- `tracker-checkpoint` when you need a dedicated checkpoint agent to own progress bookkeeping.
+
+## Minimal Progress Loop
+
+1. Register the background task before it starts.
+2. Write a start record with the task and owner.
+3. Update the state when the worker changes phase.
+4. Mark the worker blocked instead of polling forever.
+5. Mark the worker done, then clean stale state if anything remains attached.
+
+## Recommended Status Format
+
+```text
+agent: tracker-checkpoint
+task: mirror rule and guide updates
+state: running
+last_update: 2026-05-24T12:00:00+09:00
+owner: release/v0.5.2-auto-dev
+next_action: wait_for_mirror_sync
+```
+
+## Staleness Rule
+
+If a background worker stops updating, treat it as stale after a short, defined window. Do not keep polling indefinitely. Either re-plan the task, hand it off, or clean it up.
+
+## Codex/OMX Notes
+
+- The main conversation should read the newest state file, not a stale log excerpt, before deciding what to do next.
+- If the worker is a team member, the progress record should make the team lead and branch obvious.
+- A background task that has already completed should not keep emitting progress noise.
+- Legacy Claude Code background-session references can remain as compatibility notes, but the default progress surface here is `.omx/state/`.

package/templates/guides/index.yaml

@@ -8,6 +8,18 @@ guides:
     source:
       type: internal
 
+  - name: agent-teams
+    description: Agent Teams shutdown and tmux fallback troubleshooting for Codex/OMX sessions
+    path: ./agent-teams/troubleshooting.md
+    source:
+      type: internal
+
+  - name: claude-code-tracking
+    description: Background agent progress tracking and stale-state handling for Codex/OMX sessions
+    path: ./claude-code-tracking.md
+    source:
+      type: internal
+
   # Frontend
   - name: impeccable-design
     description: AI design language reference — typography, color, motion, and UX writing for production-grade UI

package/templates/manifest.json

@@ -1,11 +1,11 @@
 {
-  "version": "0.5.1",
+  "version": "0.5.3",
   "requiresCC": ">=2.1.121",
   "claudeCode": {
     "minimumVersion": "2.1.121",
     "protectedPathBypassVersion": "2.1.126"
   },
-  "lastUpdated": "2026-05-19T00:00:00.000Z",
+  "lastUpdated": "2026-05-24T00:00:00.000Z",
   "components": [
     {
       "name": "rules",
@@ -29,7 +29,7 @@
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 48
+      "files": 50
     },
     {
       "name": "hooks",

package/templates/tests/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "types": ["bun-types"]
+  },
+  "include": ["**/*.ts"]
+}