oh-my-copilot 4.13.2 → 4.13.21

package/docs/MIGRATION.md

@@ -123,30 +123,30 @@ The following skills have been **completely removed** in v3.5.3:
 
 | Removed Skill        | Replacement                            |
 | -------------------- | -------------------------------------- |
-| `cancel-autopilot`   | `/oh-my-claudecode:cancel`             |
-| `cancel-ralph`       | `/oh-my-claudecode:cancel`             |
-| `cancel-ultrawork`   | `/oh-my-claudecode:cancel`             |
-| `cancel-ultraqa`     | `/oh-my-claudecode:cancel`             |
-| `omc-default`        | `/oh-my-claudecode:omc-setup --local`  |
-| `omc-default-global` | `/oh-my-claudecode:omc-setup --global` |
-| `planner`            | `/oh-my-claudecode:plan`               |
+| `cancel-autopilot`   | `/oh-my-copilot:cancel`             |
+| `cancel-ralph`       | `/oh-my-copilot:cancel`             |
+| `cancel-ultrawork`   | `/oh-my-copilot:cancel`             |
+| `cancel-ultraqa`     | `/oh-my-copilot:cancel`             |
+| `omc-default`        | `/oh-my-copilot:omc-setup --local`  |
+| `omc-default-global` | `/oh-my-copilot:omc-setup --global` |
+| `planner`            | `/oh-my-copilot:plan`               |
 
 ### What Changed
 
 **Before v3.5.3:**
 
 ```bash
-/oh-my-claudecode:cancel-ralph      # Cancel ralph specifically
-/oh-my-claudecode:omc-default       # Configure local project
-/oh-my-claudecode:planner "task"    # Start planning
+/oh-my-copilot:cancel-ralph      # Cancel ralph specifically
+/oh-my-copilot:omc-default       # Configure local project
+/oh-my-copilot:planner "task"    # Start planning
 ```
 
 **After v3.5.3:**
 
 ```bash
-/oh-my-claudecode:cancel            # Auto-detects and cancels any active mode
-/oh-my-claudecode:omc-setup --local # Configure local project
-/oh-my-claudecode:plan "task"       # Start planning (includes interview mode)
+/oh-my-copilot:cancel            # Auto-detects and cancels any active mode
+/oh-my-copilot:omc-setup --local # Configure local project
+/oh-my-copilot:plan "task"       # Start planning (includes interview mode)
 ```
 
 ### New Features
@@ -160,8 +160,8 @@ The following skills have been **completely removed** in v3.5.3:
 **Plan skill now supports consensus mode:**
 
 ```bash
-/oh-my-claudecode:plan --consensus "task"  # Iterative planning with Critic review
-/oh-my-claudecode:ralplan "task"           # Alias for plan --consensus
+/oh-my-copilot:plan --consensus "task"  # Iterative planning with Critic review
+/oh-my-copilot:ralplan "task"           # Alias for plan --consensus
 ```
 
 ### Migration Steps
@@ -183,7 +183,7 @@ The following skills have been **completely removed** in v3.5.3:
 
 Your old commands still work! But now you don't need them.
 
-**Before 3.0:** Explicitly invoke 25+ commands like `/oh-my-claudecode:ralph "task"`, `/oh-my-claudecode:ultrawork "task"`
+**Before 3.0:** Explicitly invoke 25+ commands like `/oh-my-copilot:ralph "task"`, `/oh-my-copilot:ultrawork "task"`
 
 **After 3.0:** Just work naturally - Claude auto-activates the right behaviors. One-time setup: just say "setup omc"
 
@@ -210,13 +210,13 @@ You had to remember and explicitly invoke specific commands for each mode:
 
 ```bash
 # 2.x workflow: Multiple commands, lots to remember
-/oh-my-claudecode:ralph "implement user authentication"       # Persistence mode
-/oh-my-claudecode:ultrawork "refactor the API layer"          # Maximum parallelism
-/oh-my-claudecode:planner "plan the new dashboard"            # Planning interview
-/oh-my-claudecode:deepsearch "find database schema files"     # Deep search
-/oh-my-claudecode:git-master "commit these changes"           # Git expertise
-/oh-my-claudecode:deepinit ./src                              # Index codebase
-/oh-my-claudecode:analyze "why is this test failing?"         # Deep analysis
+/oh-my-copilot:ralph "implement user authentication"       # Persistence mode
+/oh-my-copilot:ultrawork "refactor the API layer"          # Maximum parallelism
+/oh-my-copilot:planner "plan the new dashboard"            # Planning interview
+/oh-my-copilot:deepsearch "find database schema files"     # Deep search
+/oh-my-copilot:git-master "commit these changes"           # Git expertise
+/oh-my-copilot:deepinit ./src                              # Index codebase
+/oh-my-copilot:analyze "why is this test failing?"         # Deep analysis
 ```
 
 #### After (3.0): Auto-Activation + Keywords
@@ -285,20 +285,20 @@ All 2.x commands continue to work. Here's what changed:
 
 | 2.x Command                            | 3.0 Equivalent                                     | Works?                 |
 | -------------------------------------- | -------------------------------------------------- | ---------------------- |
-| `/oh-my-claudecode:ralph "task"`       | Say "don't stop until done" OR use `ralph` keyword | ✅ YES (both ways)     |
-| `/oh-my-claudecode:ultrawork "task"`   | Say "fast" or "parallel" OR use `ulw` keyword      | ✅ YES (both ways)     |
-| `/oh-my-claudecode:ultrawork-ralph`    | Say "ralph ulw:" prefix                            | ✅ YES (keyword combo) |
-| `/oh-my-claudecode:planner "task"`     | Say "plan this" OR use `plan` keyword              | ✅ YES (both ways)     |
-| `/oh-my-claudecode:plan "description"` | Start planning naturally                           | ✅ YES                 |
-| `/oh-my-claudecode:review [path]`      | Invoke normally                                    | ✅ YES (unchanged)     |
-| `/oh-my-claudecode:deepsearch "query"` | Say "find" or "search"                             | ✅ YES (auto-detect)   |
-| `/oh-my-claudecode:analyze "target"`   | Say "analyze" — routes to debugger/architect agent | ✅ YES (keyword route) |
-| `/oh-my-claudecode:deepinit [path]`    | Invoke normally                                    | ✅ YES (unchanged)     |
-| `/oh-my-claudecode:git-master`         | Say "git", "commit", "atomic commit"               | ✅ YES (auto-detect)   |
-| `/oh-my-claudecode:frontend-ui-ux`     | Say "UI", "styling", "component", "design"         | ✅ YES (auto-detect)   |
-| `/oh-my-claudecode:note "content"`     | Say "remember this" or "save this"                 | ✅ YES (auto-detect)   |
-| `/oh-my-claudecode:cancel-ralph`       | Say "stop", "cancel", or "abort"                   | ✅ YES (auto-detect)   |
-| `/oh-my-claudecode:omc-doctor`         | Invoke normally                                    | ✅ YES (unchanged)     |
+| `/oh-my-copilot:ralph "task"`       | Say "don't stop until done" OR use `ralph` keyword | ✅ YES (both ways)     |
+| `/oh-my-copilot:ultrawork "task"`   | Say "fast" or "parallel" OR use `ulw` keyword      | ✅ YES (both ways)     |
+| `/oh-my-copilot:ultrawork-ralph`    | Say "ralph ulw:" prefix                            | ✅ YES (keyword combo) |
+| `/oh-my-copilot:planner "task"`     | Say "plan this" OR use `plan` keyword              | ✅ YES (both ways)     |
+| `/oh-my-copilot:plan "description"` | Start planning naturally                           | ✅ YES                 |
+| `/oh-my-copilot:review [path]`      | Invoke normally                                    | ✅ YES (unchanged)     |
+| `/oh-my-copilot:deepsearch "query"` | Say "find" or "search"                             | ✅ YES (auto-detect)   |
+| `/oh-my-copilot:analyze "target"`   | Say "analyze" — routes to debugger/architect agent | ✅ YES (keyword route) |
+| `/oh-my-copilot:deepinit [path]`    | Invoke normally                                    | ✅ YES (unchanged)     |
+| `/oh-my-copilot:git-master`         | Say "git", "commit", "atomic commit"               | ✅ YES (auto-detect)   |
+| `/oh-my-copilot:frontend-ui-ux`     | Say "UI", "styling", "component", "design"         | ✅ YES (auto-detect)   |
+| `/oh-my-copilot:note "content"`     | Say "remember this" or "save this"                 | ✅ YES (auto-detect)   |
+| `/oh-my-copilot:cancel-ralph`       | Say "stop", "cancel", or "abort"                   | ✅ YES (auto-detect)   |
+| `/oh-my-copilot:omc-doctor`         | Invoke normally                                    | ✅ YES (unchanged)     |
 | All other commands                     | Work exactly as before                             | ✅ YES                 |
 
 ### Magic Keywords
@@ -348,7 +348,7 @@ If in planning       → End planning interview
 If multiple active   → Stop the most recent
 ```
 
-No more `/oh-my-claudecode:cancel-ralph` - just say "cancel"!
+No more `/oh-my-copilot:cancel-ralph` - just say "cancel"!
 
 ### Migration Steps
 
@@ -442,7 +442,7 @@ After migration, verify your setup:
    ```
 
 3. **Test a simple command**:
-   Run `/oh-my-claudecode:omc-help` in Claude Code to ensure the plugin is loaded correctly.
+   Run `/oh-my-copilot:omc-help` in Claude Code to ensure the plugin is loaded correctly.
 
 ### New Features in 3.0
 
@@ -451,7 +451,7 @@ After migration, verify your setup:
 **No commands to memorize.** Work naturally:
 
 ```
-Before: "OK, I need to use /oh-my-claudecode:ultrawork for speed..."
+Before: "OK, I need to use /oh-my-copilot:ultrawork for speed..."
 After:  "I'm in a hurry, go fast!"
         ↓
         Claude: "I'm activating ultrawork mode..."
@@ -473,9 +473,9 @@ Your request              Claude's action
 
 You don't ask for delegation - it happens automatically.
 
-#### 3. Learned Skills (`/oh-my-claudecode:learner`)
+#### 3. Learned Skills (`/oh-my-copilot:skillify`)
 
-Extract reusable insights from problem-solving:
+Extract reusable insights from problem-solving. `/oh-my-copilot:learner` remains as a deprecated compatibility alias:
 
 ```bash
 # After solving a tricky bug:
@@ -499,7 +499,7 @@ See what Claude is doing in the status bar:
 [OMC] ralph:3/10 | US-002 | ultrawork skill:planner | ctx:67% | agents:2 | todos:2/5
 ```
 
-Run `/oh-my-claudecode:hud setup` to install. Presets: minimal, focused, full.
+Run `/oh-my-copilot:hud setup` to install. Presets: minimal, focused, full.
 
 #### 5. Three-Tier Memory System
 
@@ -513,10 +513,10 @@ Permanently loaded on session start
 Never lost through compaction
 ```
 
-Or use `/oh-my-claudecode:note` to save discoveries manually:
+Or use `/oh-my-copilot:note` to save discoveries manually:
 
 ```bash
-/oh-my-claudecode:note Project uses PostgreSQL with Prisma ORM
+/oh-my-copilot:note Project uses PostgreSQL with Prisma ORM
 ```
 
 #### 6. Structured Task Tracking (PRD Support)
@@ -524,7 +524,7 @@ Or use `/oh-my-claudecode:note` to save discoveries manually:
 **Ralph Loop now uses Product Requirements Documents:**
 
 ```bash
-/oh-my-claudecode:ralph-init "implement OAuth with multiple providers"
+/oh-my-copilot:ralph-init "implement OAuth with multiple providers"
     ↓
 Auto-creates PRD with user stories
     ↓
@@ -648,7 +648,7 @@ Version 3.4.0 introduces powerful parallel execution modes and advanced workflow
 Chain agents with data passing between stages:
 
 ```bash
-/oh-my-claudecode:pipeline explore:haiku -> architect:opus -> executor:sonnet
+/oh-my-copilot:pipeline explore:haiku -> architect:opus -> executor:sonnet
 ```
 
 **Built-in Presets:**
@@ -665,7 +665,7 @@ Chain agents with data passing between stages:
 Smart cancellation that auto-detects active mode:
 
 ```bash
-/oh-my-claudecode:cancel
+/oh-my-copilot:cancel
 # Or just say: "stop", "cancel", "abort"
 ```
 
@@ -674,12 +674,12 @@ Smart cancellation that auto-detects active mode:
 **Deprecation Notice:**
 Individual cancel commands are deprecated but still work:
 
-- `/oh-my-claudecode:cancel-ralph` (deprecated)
-- `/oh-my-claudecode:cancel-ultraqa` (deprecated)
-- `/oh-my-claudecode:cancel-ultrawork` (deprecated)
-- `/oh-my-claudecode:cancel-autopilot` (deprecated)
+- `/oh-my-copilot:cancel-ralph` (deprecated)
+- `/oh-my-copilot:cancel-ultraqa` (deprecated)
+- `/oh-my-copilot:cancel-ultrawork` (deprecated)
+- `/oh-my-copilot:cancel-autopilot` (deprecated)
 
-Use `/oh-my-claudecode:cancel` instead.
+Use `/oh-my-copilot:cancel` instead.
 
 #### 6. Explore-High Agent
 
@@ -720,7 +720,7 @@ When multiple execution mode keywords are present:
 **Explicit mode keywords:** `ulw`, `ultrawork`
 **Generic keywords:** `fast`, `parallel`
 
-Users set their default mode preference via `/oh-my-claudecode:omc-setup`.
+Users set their default mode preference via `/oh-my-copilot:omc-setup`.
 
 ### Migration Steps
 
@@ -802,7 +802,7 @@ After upgrading, verify new features:
 2. **Test unified cancel**:
 
    ```bash
-   /oh-my-claudecode:cancel
+   /oh-my-copilot:cancel
    ```
 
 3. **Check state directory**:
@@ -864,7 +864,7 @@ Expected timeline: Q1 2026
 **2.x Workflow:**
 
 ```
-/oh-my-claudecode:ultrawork "implement the todo list feature"
+/oh-my-copilot:ultrawork "implement the todo list feature"
 ```
 
 **3.0+ Workflow:**
@@ -882,7 +882,7 @@ Claude: "I'm activating ultrawork for maximum parallelism"
 **2.x Workflow:**
 
 ```
-/oh-my-claudecode:ralph "debug the memory leak"
+/oh-my-copilot:ralph "debug the memory leak"
 ```
 
 **3.0+ Workflow:**
@@ -900,7 +900,7 @@ Claude: "I'm activating ralph-loop to ensure completion"
 **2.x Workflow:**
 
 ```
-/oh-my-claudecode:planner "design the new authentication system"
+/oh-my-copilot:planner "design the new authentication system"
 ```
 
 **3.0+ Workflow:**
@@ -920,7 +920,7 @@ Interview begins automatically
 **2.x Workflow:**
 
 ```
-/oh-my-claudecode:cancel-ralph
+/oh-my-copilot:cancel-ralph
 ```
 
 **3.0+ Workflow:**
@@ -940,7 +940,7 @@ Interview begins automatically
 Apply oh-my-claudecode to current project only:
 
 ```
-/oh-my-claudecode:omc-default
+/oh-my-copilot:omc-default
 ```
 
 Creates: `./.claude/CLAUDE.md`
@@ -950,7 +950,7 @@ Creates: `./.claude/CLAUDE.md`
 Apply to all Claude Code sessions:
 
 ```
-/oh-my-claudecode:omc-default-global
+/oh-my-copilot:omc-default-global
 ```
 
 Creates: `~/.claude/CLAUDE.md`
@@ -968,10 +968,10 @@ A: No. Keywords are optional shortcuts. Claude auto-detects intent without them.
 A: No. All commands continue to work across minor versions (3.0 → 3.1). Major version changes (3.x → 4.0) will provide migration paths.
 
 **Q: What if I like explicit commands?**
-A: Keep using them! `/oh-my-claudecode:ralph`, `/oh-my-claudecode:ultrawork`, and `/oh-my-claudecode:plan` work. Note: `/oh-my-claudecode:planner` now redirects to `/oh-my-claudecode:plan`.
+A: Keep using them! `/oh-my-copilot:ralph`, `/oh-my-copilot:ultrawork`, and `/oh-my-copilot:plan` work. Note: `/oh-my-copilot:planner` now redirects to `/oh-my-copilot:plan`.
 
 **Q: How do I know what Claude is doing?**
-A: Claude announces major behaviors: "I'm activating ralph-loop..." or set up `/oh-my-claudecode:hud` for real-time status.
+A: Claude announces major behaviors: "I'm activating ralph-loop..." or set up `/oh-my-copilot:hud` for real-time status.
 
 **Q: Where's the full command list?**
 A: See [README.md](../README.md) for full command reference. All commands still work.
@@ -983,9 +983,9 @@ A: Keywords are explicit shortcuts. Natural language triggers auto-detection. Bo
 
 ## Need Help?
 
-- **Diagnose issues**: Run `/oh-my-claudecode:omc-doctor`
-- **See all commands**: Run `/oh-my-claudecode:omc-help`
-- **View real-time status**: Run `/oh-my-claudecode:hud setup`
+- **Diagnose issues**: Run `/oh-my-copilot:omc-doctor`
+- **See all commands**: Run `/oh-my-copilot:omc-help`
+- **View real-time status**: Run `/oh-my-copilot:hud setup`
 - **Review detailed changelog**: See [CHANGELOG.md](../CHANGELOG.md)
 - **Report bugs**: [GitHub Issues](https://github.com/Yeachan-Heo/oh-my-claudecode/issues)
 

package/docs/REFERENCE.md

@@ -12,7 +12,7 @@ Complete reference for oh-my-copilot. For quick start, see the main [README.md](
 - [CLI Commands: ask/team/session](#cli-commands-askteamsession)
 - [Legacy MCP Team Runtime Tools (Deprecated)](#legacy-mcp-team-runtime-tools-deprecated)
 - [Agents (29 Total)](#agents-29-total)
-- [Skills (35 Total)](#skills-35-total)
+- [Skills (36 Total)](#skills-36-total)
 - [Slash Commands](#slash-commands)
 - [Hooks System](#hooks-system)
 - [Magic Keywords](#magic-keywords)
@@ -520,9 +520,9 @@ Always use `oh-my-copilot:` prefix when calling via Task tool.
 
 ---
 
-## Skills (35 Total)
+## Skills (36 Total)
 
-Includes **34 canonical skills + 1 deprecated alias** (`psm`). Runtime truth comes from the builtin skill loader scanning `skills/*/SKILL.md` and expanding aliases declared in frontmatter.
+Includes **34 canonical skills + 2 deprecated aliases** (`learner`, `psm`). Runtime truth comes from the builtin skill loader scanning `skills/*/SKILL.md` and expanding aliases declared in frontmatter.
 
 | Skill                     | Description                                                      | Manual Command                              |
 | ------------------------- | ---------------------------------------------------------------- | ------------------------------------------- |
@@ -900,12 +900,29 @@ Configure HUD elements in `~/.claude/settings.json`:
 | `autopilot`  | Show autopilot status                                                                             | `true`  |
 | `showTokens` | Show transcript-derived token usage (`tok:i1.2k/o340`, plus `r...` reasoning and `s...` session total when reliable) | `false` |
 
-Additional `omcHud` layout options (top-level):
+Additional `omcHud` layout and label options (top-level):
 
 | Option     | Description                                                                       | Default    |
 | ---------- | --------------------------------------------------------------------------------- | ---------- |
 | `maxWidth` | Maximum HUD line width (terminal columns)                                         | unset      |
 | `wrapMode` | `truncate` (ellipsis) or `wrap` (break at `\|` boundaries) when `maxWidth` is set | `truncate` |
+| `locale`   | HUD label preset. Supported values: `en`, `zh-CN`                                 | `en`       |
+| `labels`   | Per-label HUD text overrides; supported keys only                                 | unset      |
+
+`locale` and `labels` affect only HUD labels. English remains the default, unsupported locale values and unknown label keys are ignored, and explicit `labels` override the locale preset. Supported label keys are `context`, `tokens`, `tool`, `agent`, `skill`, `ralph`, `background`, `thinking`, `staged`, `modified`, `untracked`, `ahead`, and `behind`.
+
+Example:
+
+```json
+{
+  "omcHud": {
+    "locale": "zh-CN",
+    "labels": {
+      "context": "CTX"
+    }
+  }
+}
+```
 
 Available presets: `minimal`, `focused`, `full`, `dense`, `analytics`, `opencode`
 

package/docs/company-context-interface.md

@@ -2,12 +2,6 @@
 
 OMC supports a narrow, prompt-level contract for vendor-owned company context.
 
-This contract is aimed at a specific failure mode from upstream issue #2692:
-purely prompt-directive company-context guidance is still missed in practice
-roughly 5% of the time. Making the lookup an explicit configured tool call
-materially reduces that miss mode at the spec layer without changing OMC
-runtime behavior.
-
 This is **not** a runtime enforcement feature. It gives OMC workflows:
 
 - a consistent tool shape,
@@ -52,8 +46,8 @@ OMC skill clauses should treat the returned markdown the same way `deep-dive` tr
 
 Configure the contract in the standard OMC config surface:
 
-- Project: `.copilot/omg.jsonc`
-- User: `~/.config/copilot-omg/config.jsonc`
+- Project: `.claude/omc.jsonc`
+- User: `~/.config/claude-omc/config.jsonc`
 
 Project config overrides user config.
 
@@ -98,23 +92,18 @@ Each skill should build a `query` that summarizes the current task, current stag
 
 The company-context server itself is still registered through the normal MCP surfaces:
 
-- Copilot CLI MCP configuration / `copilot mcp add ...`
+- Claude MCP configuration / `claude mcp add ...`
 - the unified MCP registry that OMC syncs to Codex
 
 This contract does not change how MCP servers are registered.
 
 For a tiny runnable reference implementation, see:
 
-- [`examples/vendor-mcp-server/README.md`](../examples/vendor-mcp-server/README.md)
+- [`examples/vendor-mcp-server/README.md`](/mnt/offloading/Workspace/oh-my-claudecode.omx-worktrees/issue-2692-company-context-mcp-interface/examples/vendor-mcp-server/README.md)
 
 ## Residual Risk
 
-This interface addresses the observed ~5% prompt-directive miss mode by making
-the company-context lookup explicit, but it still operates at the skill-prompt
-layer. The documented MUST-call clauses should meaningfully reduce that miss
-rate, yet they do **not** guarantee a 0% miss rate or mathematically perfect
-invocation. If you need deterministic invocation, that would require a separate
-runtime enforcement design.
+This interface makes the contract explicit and lowers prompt drift, but it still operates at the skill-prompt layer. If you need guaranteed invocation, that would require a separate runtime enforcement design.
 
 ## Non-Goals
 

package/docs/copilot-instructions.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:4.13.2 -->
+<!-- OMC:VERSION:4.13.21 -->
 
 # oh-my-copilot - Intelligent Multi-Agent Orchestration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-copilot",
-  "version": "4.13.2",
+  "version": "4.13.21",
   "description": "Multi-agent orchestration system for Copilot CLI - Inspired by oh-my-opencode",
   "type": "module",
   "main": "dist/index.js",

package/scripts/lib/hud-cache-wrapper.sh

@@ -0,0 +1,122 @@
+#!/bin/sh
+# OMC HUD cached statusLine launcher.
+#
+# Claude Code invokes statusLine commands for every render. Starting Node and
+# importing the HUD bundle each time can take hundreds of milliseconds, which
+# makes the first frame blank/flickery. This POSIX wrapper keeps the statusLine
+# protocol unchanged (stdin JSON in, one line out) while making the hot path a
+# shell read + cat of the last rendered line. A single background Node refresh
+# updates the session-scoped cache for the next frame.
+
+case "$0" in
+  */*) SCRIPT_DIR=${0%/*} ;;
+  *) SCRIPT_DIR=. ;;
+esac
+SCRIPT_DIR=$(cd "$SCRIPT_DIR" 2>/dev/null && pwd -P) || SCRIPT_DIR=.
+CONFIG_DIR=${COPILOT_CONFIG_DIR:-$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd -P)}
+CACHE_DIR=${OMC_HUD_CACHE_DIR:-"$CONFIG_DIR/hud/cache"}
+HUD_SCRIPT=${1:-"$SCRIPT_DIR/omcp-hud.mjs"}
+INPUT_TMP="$CACHE_DIR/stdin.$$.tmp"
+
+mkdir -p "$CACHE_DIR" 2>/dev/null || {
+  printf '[OMC] Starting...\n'
+  exit 0
+}
+
+# Capture Claude's current statusLine stdin first so rendered output can be
+# scoped per session/worktree instead of leaking across concurrent sessions.
+cat > "$INPUT_TMP" 2>/dev/null || :
+
+extract_json_string() {
+  key=$1
+  sed -n "s/.*\"$key\"[[:space:]]*:[[:space:]]*\"\([^\"]*\)\".*/\1/p" "$INPUT_TMP" 2>/dev/null | head -1
+}
+
+SESSION_KEY=$(extract_json_string session_id)
+if [ -z "$SESSION_KEY" ] && [ -n "${CLAUDE_SESSION_ID:-}" ]; then
+  SESSION_KEY=$CLAUDE_SESSION_ID
+fi
+if [ -z "$SESSION_KEY" ] && [ -n "${CLAUDECODE_SESSION_ID:-}" ]; then
+  SESSION_KEY=$CLAUDECODE_SESSION_ID
+fi
+TRANSCRIPT_PATH=$(extract_json_string transcript_path)
+if [ -z "$SESSION_KEY" ] && [ -n "$TRANSCRIPT_PATH" ]; then
+  SESSION_KEY=$(printf '%s\n' "$TRANSCRIPT_PATH" | sed -n 's/.*\([0-9a-fA-F][0-9a-fA-F-]\{35\}\).*/\1/p' | head -1)
+  if [ -z "$SESSION_KEY" ]; then
+    SESSION_KEY=$(printf '%s\n' "$TRANSCRIPT_PATH" | cksum 2>/dev/null | awk '{print "transcript-" $1}')
+  fi
+fi
+if [ -z "$SESSION_KEY" ]; then
+  CWD_VALUE=$(extract_json_string cwd)
+  if [ -n "$CWD_VALUE" ]; then
+    SESSION_KEY=$(printf '%s\n' "$CWD_VALUE" | cksum 2>/dev/null | awk '{print "cwd-" $1}')
+  fi
+fi
+if [ -z "$SESSION_KEY" ]; then
+  SESSION_KEY=default
+fi
+SESSION_KEY=$(printf '%s' "$SESSION_KEY" | sed 's/[^A-Za-z0-9_.-]/_/g')
+
+INPUT_FILE="$CACHE_DIR/stdin.$SESSION_KEY.json"
+OUTPUT_FILE="$CACHE_DIR/statusline.$SESSION_KEY.txt"
+LOCK_DIR="$CACHE_DIR/render.$SESSION_KEY.lock"
+NODE_STDOUT_TMP="$CACHE_DIR/statusline.$SESSION_KEY.$$.tmp"
+NODE_STDERR_TMP="$CACHE_DIR/statusline.$SESSION_KEY.$$.err"
+
+if [ -s "$INPUT_TMP" ]; then
+  mv "$INPUT_TMP" "$INPUT_FILE" 2>/dev/null || cp "$INPUT_TMP" "$INPUT_FILE" 2>/dev/null || :
+fi
+rm -f "$INPUT_TMP" 2>/dev/null || :
+
+# Hot path: return immediately from the last successful render for this session.
+if [ -s "$OUTPUT_FILE" ]; then
+  cat "$OUTPUT_FILE" 2>/dev/null || printf '[OMC] Starting...\n'
+else
+  printf '[OMC] Starting...\n'
+fi
+
+# Avoid spawning a Node renderer on every statusLine render. mkdir is atomic.
+if ! mkdir "$LOCK_DIR" 2>/dev/null; then
+  # Recover from stale locks left by crashes.
+  if [ -d "$LOCK_DIR" ]; then
+    now=$(date +%s 2>/dev/null || printf '0')
+    lock_mtime=$( (stat -c %Y "$LOCK_DIR" 2>/dev/null || stat -f %m "$LOCK_DIR" 2>/dev/null) | head -1 )
+    if [ -n "$lock_mtime" ] && [ "$now" -gt 0 ] && [ $((now - lock_mtime)) -gt 10 ]; then
+      rm -rf "$LOCK_DIR" 2>/dev/null || :
+      mkdir "$LOCK_DIR" 2>/dev/null || exit 0
+    else
+      exit 0
+    fi
+  else
+    exit 0
+  fi
+fi
+
+refresh_cache() {
+  if [ ! -s "$INPUT_FILE" ]; then
+    rm -rf "$LOCK_DIR" 2>/dev/null || :
+    return
+  fi
+
+  if [ -x "$SCRIPT_DIR/find-node.sh" ]; then
+    sh "$SCRIPT_DIR/find-node.sh" "$HUD_SCRIPT" < "$INPUT_FILE" > "$NODE_STDOUT_TMP" 2> "$NODE_STDERR_TMP"
+  else
+    node "$HUD_SCRIPT" < "$INPUT_FILE" > "$NODE_STDOUT_TMP" 2> "$NODE_STDERR_TMP"
+  fi
+
+  # Keep the last good line if rendering fails or returns empty output.
+  if [ -s "$NODE_STDOUT_TMP" ]; then
+    mv "$NODE_STDOUT_TMP" "$OUTPUT_FILE" 2>/dev/null || cp "$NODE_STDOUT_TMP" "$OUTPUT_FILE" 2>/dev/null || :
+  fi
+
+  rm -f "$NODE_STDOUT_TMP" "$NODE_STDERR_TMP" 2>/dev/null || :
+  rm -rf "$LOCK_DIR" 2>/dev/null || :
+}
+
+if [ "${OMC_HUD_SYNC_REFRESH:-0}" = "1" ]; then
+  refresh_cache
+else
+  ( refresh_cache ) >/dev/null 2>&1 &
+fi
+
+exit 0

package/scripts/plugin-setup.mjs

@@ -35,6 +35,11 @@ if (!existsSync(HUD_LIB_DIR)) {
   mkdirSync(HUD_LIB_DIR, { recursive: true });
 }
 copyFileSync(join(__dirname, 'lib', 'config-dir.mjs'), join(HUD_LIB_DIR, 'config-dir.mjs'));
+copyFileSync(join(__dirname, 'lib', 'config-dir.sh'), join(HUD_LIB_DIR, 'config-dir.sh'));
+copyFileSync(join(__dirname, 'find-node.sh'), join(HUD_DIR, 'find-node.sh'));
+copyFileSync(join(__dirname, 'lib', 'hud-cache-wrapper.sh'), join(HUD_DIR, 'omcp-hud-cache.sh'));
+try { chmodSync(join(HUD_DIR, 'find-node.sh'), 0o755); } catch { /* Windows doesn't need this */ }
+try { chmodSync(join(HUD_DIR, 'omcp-hud-cache.sh'), 0o755); } catch { /* Windows doesn't need this */ }
 
 // 2. Create HUD wrapper script
 const hudScriptPath = join(HUD_DIR, 'omcp-hud.mjs').replace(/\\/g, '/');
@@ -238,9 +243,13 @@ try {
     settings = JSON.parse(readFileSync(SETTINGS_FILE, 'utf-8'));
   }
 
+  const statusLineCommand = process.platform === 'win32'
+    ? `"${nodeBin}" "${hudScriptPath.replace(/\\/g, "/")}"`
+    : `sh "${join(HUD_DIR, 'omcp-hud-cache.sh').replace(/\\/g, "/")}" "${hudScriptPath.replace(/\\/g, "/")}"`;
+
   settings.statusLine = {
     type: 'command',
-    command: `"${nodeBin}" "${hudScriptPath.replace(/\\/g, "/")}"`
+    command: statusLineCommand
   };
   writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2));
   console.log('[OMC] Configured HUD statusLine in settings.json');