oh-my-customcode 0.42.3 → 0.43.1

package/dist/cli/index.js

@@ -9376,7 +9376,9 @@ 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);
@@ -14207,7 +14209,7 @@ async function doctorCommand(options = {}) {
 }
 
 // src/cli/init.ts
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 
 // src/core/installer.ts
 init_fs();
@@ -15063,6 +15065,83 @@ async function checkUvAvailable() {
 // src/cli/init.ts
 init_fs();
 
+// src/cli/serve.ts
+import { spawn } from "node:child_process";
+import { existsSync as existsSync2 } from "node:fs";
+import { readFile as readFile2, unlink, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join9 } from "node:path";
+var DEFAULT_PORT = 4321;
+var PID_FILE = join9(process.env.HOME ?? "~", ".omcustom-serve.pid");
+function findServeBuildDir(projectRoot) {
+  const localBuild = join9(projectRoot, "packages", "serve", "build");
+  if (existsSync2(join9(localBuild, "index.js")))
+    return localBuild;
+  const npmBuild = join9(import.meta.dirname, "..", "..", "packages", "serve", "build");
+  if (existsSync2(join9(npmBuild, "index.js")))
+    return npmBuild;
+  return null;
+}
+async function isServeRunning() {
+  try {
+    const raw = await readFile2(PID_FILE, "utf-8");
+    const pid = Number(raw.trim());
+    if (!Number.isFinite(pid) || pid <= 0) {
+      await cleanupPidFile();
+      return false;
+    }
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    await cleanupPidFile();
+    return false;
+  }
+}
+async function startServeBackground(projectRoot, port = DEFAULT_PORT) {
+  if (await isServeRunning()) {
+    return;
+  }
+  const buildDir = findServeBuildDir(projectRoot);
+  if (buildDir === null) {
+    return;
+  }
+  const child = spawn("node", [join9(buildDir, "index.js")], {
+    env: {
+      ...process.env,
+      OMCUSTOM_PORT: String(port),
+      OMCUSTOM_HOST: "localhost",
+      OMCUSTOM_ORIGIN: `http://localhost:${port}`,
+      OMCUSTOM_PROJECT_ROOT: projectRoot
+    },
+    stdio: "ignore",
+    detached: true
+  });
+  child.unref();
+  if (child.pid !== undefined) {
+    await writeFile2(PID_FILE, String(child.pid), "utf-8");
+  }
+}
+async function stopServe() {
+  try {
+    const raw = await readFile2(PID_FILE, "utf-8");
+    const pid = Number(raw.trim());
+    if (!Number.isFinite(pid) || pid <= 0) {
+      await cleanupPidFile();
+      return false;
+    }
+    process.kill(pid, "SIGTERM");
+    await cleanupPidFile();
+    return true;
+  } catch {
+    await cleanupPidFile();
+    return false;
+  }
+}
+async function cleanupPidFile() {
+  try {
+    await unlink(PID_FILE);
+  } catch {}
+}
+
 // node_modules/.bun/@clack+core@1.1.0/node_modules/@clack/core/dist/index.mjs
 import { styleText as D } from "node:util";
 import { stdout as R, stdin as q } from "node:process";
@@ -16040,7 +16119,7 @@ async function runInitWizard(options) {
 // src/cli/init.ts
 async function checkExistingInstallation(targetDir) {
   const layout = getProviderLayout();
-  const rootDir = join9(targetDir, layout.rootDir);
+  const rootDir = join10(targetDir, layout.rootDir);
   return fileExists(rootDir);
 }
 var PROVIDER_SUBDIR_COMPONENTS = new Set([
@@ -16054,13 +16133,13 @@ var PROVIDER_SUBDIR_COMPONENTS = new Set([
 function componentToPath(targetDir, component) {
   if (component === "entry-md") {
     const layout = getProviderLayout();
-    return join9(targetDir, layout.entryFile);
+    return join10(targetDir, layout.entryFile);
   }
   if (PROVIDER_SUBDIR_COMPONENTS.has(component)) {
     const layout = getProviderLayout();
-    return join9(targetDir, layout.rootDir, component);
+    return join10(targetDir, layout.rootDir, component);
   }
-  return join9(targetDir, component);
+  return join10(targetDir, component);
 }
 function buildInstalledPaths(targetDir, components) {
   return components.map((component) => componentToPath(targetDir, component));
@@ -16162,6 +16241,8 @@ async function initCommand(options) {
     console.log("  /plugin install context7");
     console.log("");
     console.log('See CLAUDE.md "외부 의존성" section for details.');
+    await startServeBackground(targetDir).catch(() => {});
+    console.log(`Web UI: http://127.0.0.1:${DEFAULT_PORT}`);
     return {
       success: true,
       message: i18n.t("cli.init.success"),
@@ -16175,7 +16256,7 @@ async function initCommand(options) {
 }
 
 // src/cli/list.ts
-import { basename as basename3, dirname as dirname3, join as join10, relative as relative3 } from "node:path";
+import { basename as basename3, dirname as dirname3, join as join11, relative as relative3 } from "node:path";
 init_fs();
 var ALLOWED_TOP_LEVEL_KEYS = new Set(["name", "type", "description", "version", "category"]);
 function parseKeyValue(line) {
@@ -16240,12 +16321,12 @@ function extractAgentTypeFromFilename(filename) {
   return prefixMap[prefix] || "unknown";
 }
 function extractSkillCategoryFromPath(skillPath, baseDir, rootDir) {
-  const relativePath = relative3(join10(baseDir, rootDir, "skills"), skillPath);
+  const relativePath = relative3(join11(baseDir, rootDir, "skills"), skillPath);
   const parts = relativePath.split("/").filter(Boolean);
   return parts[0] || "unknown";
 }
 function extractGuideCategoryFromPath(guidePath, baseDir) {
-  const relativePath = relative3(join10(baseDir, "guides"), guidePath);
+  const relativePath = relative3(join11(baseDir, "guides"), guidePath);
   const parts = relativePath.split("/").filter(Boolean);
   return parts[0] || "unknown";
 }
@@ -16339,7 +16420,7 @@ async function tryExtractMarkdownDescription(mdPath, options = {}) {
   }
 }
 async function getAgents(targetDir, rootDir = ".claude", config) {
-  const agentsDir = join10(targetDir, rootDir, "agents");
+  const agentsDir = join11(targetDir, rootDir, "agents");
   if (!await fileExists(agentsDir))
     return [];
   try {
@@ -16367,7 +16448,7 @@ async function getAgents(targetDir, rootDir = ".claude", config) {
   }
 }
 async function getSkills(targetDir, rootDir = ".claude", config) {
-  const skillsDir = join10(targetDir, rootDir, "skills");
+  const skillsDir = join11(targetDir, rootDir, "skills");
   if (!await fileExists(skillsDir))
     return [];
   try {
@@ -16377,7 +16458,7 @@ async function getSkills(targetDir, rootDir = ".claude", config) {
     const skillMdFiles = await listFiles(skillsDir, { recursive: true, pattern: "SKILL.md" });
     const skills = await Promise.all(skillMdFiles.map(async (skillMdPath) => {
       const skillDir = dirname3(skillMdPath);
-      const indexYamlPath = join10(skillDir, "index.yaml");
+      const indexYamlPath = join11(skillDir, "index.yaml");
       const { description, version } = await tryReadIndexYamlMetadata(indexYamlPath);
       const relativePath = relative3(targetDir, skillDir);
       return {
@@ -16396,7 +16477,7 @@ async function getSkills(targetDir, rootDir = ".claude", config) {
   }
 }
 async function getGuides(targetDir, config) {
-  const guidesDir = join10(targetDir, "guides");
+  const guidesDir = join11(targetDir, "guides");
   if (!await fileExists(guidesDir))
     return [];
   try {
@@ -16423,7 +16504,7 @@ async function getGuides(targetDir, config) {
 }
 var RULE_PRIORITY_ORDER = { MUST: 0, SHOULD: 1, MAY: 2 };
 async function getRules(targetDir, rootDir = ".claude", config) {
-  const rulesDir = join10(targetDir, rootDir, "rules");
+  const rulesDir = join11(targetDir, rootDir, "rules");
   if (!await fileExists(rulesDir))
     return [];
   try {
@@ -16495,7 +16576,7 @@ function formatAsJson(components) {
   console.log(JSON.stringify(components, null, 2));
 }
 async function getHooks(targetDir, rootDir = ".claude") {
-  const hooksDir = join10(targetDir, rootDir, "hooks");
+  const hooksDir = join11(targetDir, rootDir, "hooks");
   if (!await fileExists(hooksDir))
     return [];
   try {
@@ -16513,7 +16594,7 @@ async function getHooks(targetDir, rootDir = ".claude") {
   }
 }
 async function getContexts(targetDir, rootDir = ".claude") {
-  const contextsDir = join10(targetDir, rootDir, "contexts");
+  const contextsDir = join11(targetDir, rootDir, "contexts");
   if (!await fileExists(contextsDir))
     return [];
   try {
@@ -16901,9 +16982,73 @@ async function securityCommand(_options = {}) {
   };
 }
 
+// src/cli/serve-commands.ts
+import { execFile, spawnSync as spawnSync2 } from "node:child_process";
+import { join as join12 } from "node:path";
+async function serveCommand(options) {
+  const port = options.port !== undefined ? Number(options.port) : DEFAULT_PORT;
+  if (!Number.isFinite(port) || port < 1 || port > 65535) {
+    console.error(`Invalid port: ${options.port}`);
+    process.exit(1);
+  }
+  const cwd = process.cwd();
+  if (options.foreground === true) {
+    runForeground(cwd, port);
+    return;
+  }
+  await startServeBackground(cwd, port);
+  const running = await isServeRunning();
+  if (running) {
+    console.log(`Web UI started: http://127.0.0.1:${port}`);
+    if (options.open === true) {
+      openBrowser(port);
+    }
+  } else {
+    console.error("Failed to start Web UI server");
+    process.exit(1);
+  }
+}
+async function serveStopCommand() {
+  const stopped = await stopServe();
+  if (stopped) {
+    console.log("Web UI server stopped");
+  } else {
+    console.log("Web UI server is not running");
+  }
+}
+function runForeground(projectRoot, port) {
+  const buildDir = findServeBuildDir(projectRoot);
+  if (buildDir === null) {
+    console.error("Web UI build not found. Run: cd packages/serve && bun run build");
+    process.exit(1);
+  }
+  console.log(`Web UI: http://127.0.0.1:${port}`);
+  spawnSync2("node", [join12(buildDir, "index.js")], {
+    env: {
+      ...process.env,
+      OMCUSTOM_PORT: String(port),
+      OMCUSTOM_HOST: "localhost",
+      OMCUSTOM_ORIGIN: `http://localhost:${port}`,
+      OMCUSTOM_PROJECT_ROOT: projectRoot
+    },
+    stdio: "inherit"
+  });
+}
+function openBrowser(port) {
+  const url = `http://127.0.0.1:${port}`;
+  const platform = process.platform;
+  if (platform === "darwin") {
+    execFile("open", [url], () => {});
+  } else if (platform === "win32") {
+    execFile("cmd", ["/c", "start", url], () => {});
+  } else {
+    execFile("xdg-open", [url], () => {});
+  }
+}
+
 // src/core/updater.ts
 init_fs();
-import { join as join11 } from "node:path";
+import { join as join13 } from "node:path";
 
 // src/core/entry-merger.ts
 var MANAGED_START = "<!-- omcustom:start -->";
@@ -17152,7 +17297,7 @@ function resolveCustomizations(customizations, configPreserveFiles, targetDir) {
 }
 async function updateEntryDoc(targetDir, config, options) {
   const layout = getProviderLayout();
-  const entryPath = join11(targetDir, layout.entryFile);
+  const entryPath = join13(targetDir, layout.entryFile);
   const templateName = getEntryTemplateName2(config.language);
   const templatePath = resolveTemplatePath(templateName);
   if (!await fileExists(templatePath)) {
@@ -17298,7 +17443,7 @@ async function collectProtectedSkipPaths(srcPath, destPath, componentPath, force
   }
   const protectedRelative = await findProtectedFilesInDir(srcPath, componentPath);
   const path3 = await import("node:path");
-  const skipPaths = protectedRelative.map((p) => path3.relative(destPath, join11(destPath, p)));
+  const skipPaths = protectedRelative.map((p) => path3.relative(destPath, join13(destPath, p)));
   return { skipPaths, warnedPaths: protectedRelative };
 }
 function isEntryProtected(relPath, componentRelativePrefix) {
@@ -17339,7 +17484,7 @@ async function updateComponent(targetDir, component, customizations, options, co
   const preservedFiles = [];
   const componentPath = getComponentPath2(component);
   const srcPath = resolveTemplatePath(componentPath);
-  const destPath = join11(targetDir, componentPath);
+  const destPath = join13(targetDir, componentPath);
   const customComponents = config.customComponents || [];
   const skipPaths = [];
   if (customizations && !options.forceOverwriteAll) {
@@ -17370,7 +17515,7 @@ async function updateComponent(targetDir, component, customizations, options, co
   }
   skipPaths.push(...protectedSkipPaths);
   const path3 = await import("node:path");
-  const normalizedSkipPaths = skipPaths.map((p) => path3.relative(destPath, join11(targetDir, p)));
+  const normalizedSkipPaths = skipPaths.map((p) => path3.relative(destPath, join13(targetDir, p)));
   const uniqueSkipPaths = [...new Set(normalizedSkipPaths)];
   await copyDirectory(srcPath, destPath, {
     overwrite: true,
@@ -17392,12 +17537,12 @@ async function syncRootLevelFiles(targetDir, options) {
   const layout = getProviderLayout();
   const synced = [];
   for (const fileName of ROOT_LEVEL_FILES) {
-    const srcPath = resolveTemplatePath(join11(layout.rootDir, fileName));
+    const srcPath = resolveTemplatePath(join13(layout.rootDir, fileName));
     if (!await fileExists(srcPath)) {
       continue;
     }
-    const destPath = join11(targetDir, layout.rootDir, fileName);
-    await ensureDirectory(join11(destPath, ".."));
+    const destPath = join13(targetDir, layout.rootDir, fileName);
+    await ensureDirectory(join13(destPath, ".."));
     await fs3.copyFile(srcPath, destPath);
     if (fileName.endsWith(".sh")) {
       await fs3.chmod(destPath, 493);
@@ -17432,7 +17577,7 @@ async function removeDeprecatedFiles(targetDir, options) {
       });
       continue;
     }
-    const fullPath = join11(targetDir, entry.path);
+    const fullPath = join13(targetDir, entry.path);
     if (await fileExists(fullPath)) {
       await fs3.unlink(fullPath);
       removed.push(entry.path);
@@ -17456,26 +17601,26 @@ function getComponentPath2(component) {
 }
 async function backupInstallation(targetDir) {
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const backupDir = join11(targetDir, `.omcustom-backup-${timestamp}`);
+  const backupDir = join13(targetDir, `.omcustom-backup-${timestamp}`);
   const fs3 = await import("node:fs/promises");
   await ensureDirectory(backupDir);
   const layout = getProviderLayout();
   const dirsToBackup = [layout.rootDir, "guides"];
   for (const dir2 of dirsToBackup) {
-    const srcPath = join11(targetDir, dir2);
+    const srcPath = join13(targetDir, dir2);
     if (await fileExists(srcPath)) {
-      const destPath = join11(backupDir, dir2);
+      const destPath = join13(backupDir, dir2);
       await copyDirectory(srcPath, destPath, { overwrite: true });
     }
   }
-  const entryPath = join11(targetDir, layout.entryFile);
+  const entryPath = join13(targetDir, layout.entryFile);
   if (await fileExists(entryPath)) {
-    await fs3.copyFile(entryPath, join11(backupDir, layout.entryFile));
+    await fs3.copyFile(entryPath, join13(backupDir, layout.entryFile));
   }
   return backupDir;
 }
 async function loadCustomizationManifest(targetDir) {
-  const manifestPath = join11(targetDir, CUSTOMIZATION_MANIFEST_FILE);
+  const manifestPath = join13(targetDir, CUSTOMIZATION_MANIFEST_FILE);
   if (await fileExists(manifestPath)) {
     return readJsonFile(manifestPath);
   }
@@ -17585,6 +17730,12 @@ function createProgram() {
     const result = await securityCommand(options);
     process.exitCode = result.success ? 0 : 1;
   });
+  program2.command("serve").description("Start the web UI server").option("-p, --port <port>", "Port number", "4321").option("--open", "Open browser automatically").option("--foreground", "Run in foreground (not detached)").action(async (options) => {
+    await serveCommand(options);
+  });
+  program2.command("serve-stop").description("Stop the web UI server").action(async () => {
+    await serveStopCommand();
+  });
   program2.hook("preAction", async (thisCommand, actionCommand) => {
     const opts = thisCommand.optsWithGlobals();
     const skipCheck = opts.skipVersionCheck || false;
@@ -17600,6 +17751,13 @@ 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.42.3",
+  "version": "0.43.1",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

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

@@ -115,6 +115,16 @@
           }
         ],
         "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/hooks/scripts/serve-autostart.sh

@@ -0,0 +1,71 @@
+#!/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

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.42.3",
+  "version": "0.43.1",
   "lastUpdated": "2026-03-16T00:00:00.000Z",
   "components": [
     {