oh-my-customcode 0.43.1 → 0.44.0

package/README.md

@@ -13,7 +13,7 @@
 
 **[한국어 문서 (Korean)](./README_ko.md)**
 
-44 agents. 75 skills. 21 rules. One command.
+44 agents. 76 skills. 21 rules. One command.
 
 ```bash
 npm install -g oh-my-customcode && cd your-project && omcustom init
@@ -138,7 +138,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
 
 ---
 
-### Skills (75)
+### Skills (76)
 
 | Category | Count | Includes |
 |----------|-------|----------|

package/dist/cli/index.js

@@ -9376,9 +9376,7 @@ var require_src = __commonJS((exports, module) => {
 });
 
 // src/cli/index.ts
-import { existsSync as existsSync3 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
-import { join as join14 } from "node:path";
 
 // node_modules/.bun/commander@14.0.2/node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
@@ -17751,13 +17749,6 @@ function createProgram() {
       console.warn(warnings);
       console.warn("");
     }
-    const commandName = actionCommand.name();
-    if (commandName !== "serve-stop" && commandName !== "serve") {
-      const cwd = process.cwd();
-      if (existsSync3(join14(cwd, ".claude"))) {
-        startServeBackground(cwd).catch(() => {});
-      }
-    }
   });
   return program2;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "oh-my-customcode",
   "workspaces": ["packages/*"],
-  "version": "0.43.1",
+  "version": "0.44.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/hooks/hooks.json

@@ -115,16 +115,6 @@
           }
         ],
         "description": "Check codex CLI and Agent Teams availability at session start"
-      },
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/scripts/serve-autostart.sh"
-          }
-        ],
-        "description": "Auto-start Web UI (packages/serve) in background if not already running"
       }
     ],
     "SubagentStart": [

package/templates/.claude/skills/omcustom-web/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: omcustom:web
+description: Control and inspect the built-in Web UI (packages/serve) — start, stop, status, open
+scope: harness
+argument-hint: "[start|stop|status|open]"
+user-invocable: true
+---
+
+# Web UI Control
+
+Interactive control for the built-in Web UI server (packages/serve).
+
+## Arguments
+
+| Argument | Action |
+|----------|--------|
+| `status` (default) | Show server status (PID, port, URL) |
+| `start` | Start the Web UI server in background |
+| `stop` | Stop the running Web UI server |
+| `open` | Open the Web UI in the default browser |
+
+## Workflow
+
+### Step 1: Check Server Status
+
+Run these checks via Bash:
+
+```bash
+PORT=${OMCUSTOM_PORT:-4321}
+PID_FILE="$HOME/.omcustom-serve.pid"
+PID=$(cat "$PID_FILE" 2>/dev/null)
+
+# Process alive?
+if [ -n "$PID" ] && kill -0 "$PID" 2>/dev/null; then
+  STATUS="running"
+else
+  STATUS="stopped"
+  # Clean stale PID file
+  [ -f "$PID_FILE" ] && rm "$PID_FILE"
+fi
+
+# Port check
+PORT_PID=$(lsof -ti :$PORT 2>/dev/null | head -1)
+
+echo "STATUS=$STATUS PID=$PID PORT=$PORT PORT_PID=$PORT_PID"
+```
+
+### Step 2: Display Status
+
+```
+Web UI Control
+─────────────
+Status: ● Running (PID {PID})
+URL:    http://localhost:{PORT}
+Log:    ~/.omcustom-serve.log
+```
+
+or
+
+```
+Web UI Control
+─────────────
+Status: ○ Stopped
+Port:   {PORT} (free)
+```
+
+### Step 3: Execute Subcommand
+
+| Subcommand | Action |
+|------------|--------|
+| `status` | Display status from Step 2, then exit |
+| `start` | If stopped → run `omcustom serve` via Bash. If running → show URL |
+| `stop` | If running → run `omcustom serve-stop` via Bash. If stopped → inform user |
+| `open` | If running → `open http://localhost:{PORT}` (macOS). If stopped → ask to start first |
+
+### Step 4: Port Conflict Detection
+
+Before `start`, check if port is already occupied by another process:
+
+```bash
+PORT_PID=$(lsof -ti :$PORT 2>/dev/null | head -1)
+if [ -n "$PORT_PID" ]; then
+  PROC=$(ps -p $PORT_PID -o comm= 2>/dev/null)
+  echo "Port $PORT is occupied by $PROC (PID $PORT_PID)"
+fi
+```
+
+If occupied by a non-serve process, warn the user and suggest `--port` option.
+
+## No Argument Behavior
+
+When called without arguments (`/omcustom:web`):
+1. Show status
+2. If stopped, suggest: "Run `/omcustom:web start` to start the server"
+3. If running, suggest: "Run `/omcustom:web open` to open in browser"

package/templates/CLAUDE.md

@@ -131,7 +131,7 @@ project/
 +-- CLAUDE.md                    # 진입점
 +-- .claude/
 |   +-- agents/                  # 서브에이전트 정의 (44 파일)
-|   +-- skills/                  # 스킬 (75 디렉토리)
+|   +-- skills/                  # 스킬 (76 디렉토리)
 |   +-- rules/                   # 전역 규칙 (R000-R021)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.43.1",
+  "version": "0.44.0",
   "lastUpdated": "2026-03-16T00:00:00.000Z",
   "components": [
     {
@@ -18,7 +18,7 @@
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 75
+      "files": 76
     },
     {
       "name": "guides",

package/templates/.claude/hooks/scripts/serve-autostart.sh

@@ -1,71 +0,0 @@
-#!/bin/bash
-# Web UI Auto-start Hook
-# Trigger: SessionStart
-# Purpose: Start packages/serve in the background if not already running
-# Protocol: stdin JSON -> stdout pass-through, exit 0 always (never blocks session start)
-
-input=$(cat)
-
-PID_FILE="$HOME/.omcustom-serve.pid"
-
-# Check if already running
-if [ -f "$PID_FILE" ]; then
-  EXISTING_PID=$(cat "$PID_FILE" 2>/dev/null || echo "")
-  if [ -n "$EXISTING_PID" ] && kill -0 "$EXISTING_PID" 2>/dev/null; then
-    # Server already running — silently pass through
-    echo "$input"
-    exit 0
-  else
-    # Stale PID file — clean it up
-    rm -f "$PID_FILE"
-  fi
-fi
-
-# Resolve project root: script lives at .claude/hooks/scripts/ -> 3 levels up
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../../.." && pwd)"
-
-# Prefer git-based root detection if available
-if command -v git >/dev/null 2>&1; then
-  GIT_ROOT=$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || echo "")
-  if [ -n "$GIT_ROOT" ]; then
-    PROJECT_ROOT="$GIT_ROOT"
-  fi
-fi
-
-# Locate the build artifact
-BUILD_FILE="${PROJECT_ROOT}/packages/serve/build/index.js"
-
-if [ ! -f "$BUILD_FILE" ]; then
-  # Build not present — skip silently (advisory only)
-  echo "[Hook] Web UI build not found, skipping auto-start (${BUILD_FILE})" >&2
-  echo "$input"
-  exit 0
-fi
-
-# Ensure node is available
-if ! command -v node >/dev/null 2>&1; then
-  echo "[Hook] node not found, skipping Web UI auto-start" >&2
-  echo "$input"
-  exit 0
-fi
-
-# Start server fully detached from current process group
-OMCUSTOM_PORT="${OMCUSTOM_PORT:-4321}"
-OMCUSTOM_HOST="${OMCUSTOM_HOST:-localhost}"
-PORT="$OMCUSTOM_PORT"
-HOST="$OMCUSTOM_HOST"
-
-nohup env OMCUSTOM_PORT="$OMCUSTOM_PORT" OMCUSTOM_HOST="$OMCUSTOM_HOST" OMCUSTOM_ORIGIN="http://localhost:${PORT}" node "$BUILD_FILE" \
-  >"$HOME/.omcustom-serve.log" 2>&1 \
-  </dev/null &
-SERVER_PID=$!
-disown "$SERVER_PID"
-
-echo "$SERVER_PID" > "$PID_FILE"
-
-echo "[Hook] Web UI started (PID ${SERVER_PID}): http://${HOST}:${PORT}" >&2
-
-# Pass through stdin JSON
-echo "$input"
-exit 0