oh-my-customcode 0.10.3 → 0.12.0

package/README.md

@@ -4,7 +4,7 @@
 
 # oh-my-customcode
 
-> **Your Claude Code, Your Way**
+> **Your Coding Agent Stack, Your Way**
 
 [![npm version](https://img.shields.io/npm/v/oh-my-customcode.svg)](https://www.npmjs.com/package/oh-my-customcode)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -13,9 +13,9 @@
 
 **[한국어 문서 (Korean)](./README_ko.md)**
 
-**The easiest way to customize Claude Code with agents, skills, and rules.**
+**The easiest way to customize Claude Code and OpenAI Codex with agents, skills, and rules.**
 
-Like oh-my-zsh transformed shell customization, oh-my-customcode makes personalizing your Claude Code experience simple, powerful, and fun.
+Like oh-my-zsh transformed shell customization, oh-my-customcode makes personalizing your coding agent workflow simple, powerful, and fun.
 
 ## What Makes It Special
 
@@ -38,19 +38,19 @@ cd your-project
 omcustom init
 ```
 
-That's it. You now have a fully configured Claude Code environment.
+That's it. You now have a fully configured agent environment.
 
 ---
 
-> **Codex CLI Support**: Experimental Codex CLI mode is available. See `AGENTS.md` and `.codex/` for Codex-native configuration.
+> **Dual Provider Support**: Claude and Codex are both supported. Use `--provider claude|codex` (or auto-detect) during `omcustom init`/`update`/`list`/`doctor`.
 
 ## Customization First
 
-This is what oh-my-customcode is all about. **Making Claude Code yours.**
+This is what oh-my-customcode is all about. **Making your coding workflow yours.**
 
-### Just Tell Claude What You Need
+### Just Describe What You Need
 
-No manual file editing. Describe what you want in natural language, and the orchestrator delegates to the right agent:
+No manual file editing. Describe what you want in natural language, and routing skills plus manager agents delegate to the right sub-agent:
 
 ```
 "Create a migration review expert agent"
@@ -63,13 +63,13 @@ No manual file editing. Describe what you want in natural language, and the orch
 
 ```
 User (natural language)
-  → /create-agent (routing skill)
+  → secretary-routing (routing skill)
     → mgr-creator:sonnet       — scaffolds agent, registers, verifies
     → mgr-updater:sonnet       — syncs documentation
     → mgr-supplier:haiku       — checks dependencies
 ```
 
-Claude Code's routing system analyzes your request, routes it to the appropriate skill and agent, and the sub-agent handles everything automatically.
+The routing chain analyzes your request, maps it to the appropriate skill and manager agent, and the selected sub-agent handles execution automatically.
 
 ### Sub-Agent Model
 
@@ -81,6 +81,8 @@ Each sub-agent runs on an optimized model for its task type:
 | `sonnet` | General tasks (default) | Agent creation, code generation |
 | `haiku` | Fast, simple operations | File search, validation |
 
+> Note: Claude examples keep `opus/sonnet/haiku`. Codex-native templates use profile terms: `reasoning/balanced/fast`.
+
 Claude Code selects the appropriate model and parallelizes independent tasks (up to 4 concurrent sub-agents):
 
 ```
@@ -126,18 +128,110 @@ Claude Code selects the appropriate model and parallelizes independent tasks (up
 | **QA** | 3 | qa-planner, qa-writer, qa-engineer |
 | **Total** | **42** | |
 
-### Skills (51)
+Canonical agent IDs (`templates/.claude/agents/*.md`):
+
+```text
+arch-documenter
+arch-speckit-agent
+be-express-expert
+be-fastapi-expert
+be-go-backend-expert
+be-nestjs-expert
+be-springboot-expert
+db-postgres-expert
+db-redis-expert
+db-supabase-expert
+de-airflow-expert
+de-dbt-expert
+de-kafka-expert
+de-pipeline-expert
+de-snowflake-expert
+de-spark-expert
+fe-svelte-agent
+fe-vercel-agent
+fe-vuejs-agent
+infra-aws-expert
+infra-docker-expert
+lang-golang-expert
+lang-java21-expert
+lang-kotlin-expert
+lang-python-expert
+lang-rust-expert
+lang-typescript-expert
+mgr-claude-code-bible
+mgr-creator
+mgr-gitnerd
+mgr-sauron
+mgr-supplier
+mgr-sync-checker
+mgr-updater
+qa-engineer
+qa-planner
+qa-writer
+sys-memory-keeper
+sys-naggy
+tool-bun-expert
+tool-npm-expert
+tool-optimizer
+```
 
-Includes slash commands and capabilities:
+### Skills (51)
 
-- **Development** (8): Go, Python, TypeScript, Kotlin, Rust, Java, React, Vercel
-- **Backend** (5): FastAPI, Spring Boot, Express, NestJS, Go Backend
-- **Data Engineering** (6): Airflow, dbt, Spark, Kafka, Snowflake, Pipeline
-- **Database** (3): Supabase, PostgreSQL, Redis
-- **Infrastructure** (2): Docker, AWS
-- **System** (2): Memory management, result aggregation
-- **Orchestration** (4): secretary-routing, dev-lead-routing, de-lead-routing, qa-lead-routing
-- **Slash Commands** (20+): /create-agent, /code-review, /audit-dependencies, /sync-check, /commit, /pr, and more
+Canonical skill IDs (`templates/.claude/skills/*/SKILL.md`):
+
+```text
+airflow-best-practices
+audit-agents
+aws-best-practices
+claude-code-bible
+create-agent
+dbt-best-practices
+de-lead-routing
+dev-lead-routing
+dev-refactor
+dev-review
+docker-best-practices
+fastapi-best-practices
+fix-refs
+go-backend-best-practices
+go-best-practices
+help
+intent-detection
+kafka-best-practices
+kotlin-best-practices
+lists
+memory-management
+memory-recall
+memory-save
+monitoring-setup
+npm-audit
+npm-publish
+npm-version
+optimize-analyze
+optimize-bundle
+optimize-report
+pipeline-architecture-patterns
+postgres-best-practices
+python-best-practices
+qa-lead-routing
+react-best-practices
+redis-best-practices
+result-aggregation
+rust-best-practices
+sauron-watch
+secretary-routing
+snowflake-best-practices
+spark-best-practices
+springboot-best-practices
+status
+supabase-postgres-best-practices
+typescript-best-practices
+update-docs
+update-external
+vercel-deploy
+web-design-guidelines
+writing-clearly-and-concisely
+```
 
 ### Guides (22)
 
@@ -160,12 +254,18 @@ Comprehensive reference documentation covering:
 
 ### Hooks (1)
 
-Event-driven automation for Claude Code lifecycle events (PreToolUse, PostToolUse, etc.).
+Event-driven automation for agent lifecycle events (PreToolUse, PostToolUse, etc.).
 
 ### Contexts (4)
 
 Shared context files for cross-agent knowledge and mode configurations.
 
+### Packages
+
+| Package | Version | Description |
+|---------|---------|-------------|
+| [ontology-rag](packages/ontology-rag/) | 0.3.0 | Ontology+RAG context engine for intelligent context loading. Reduces token usage by 75-95% through hierarchical loading, graph-based routing, and adaptive compression. |
+
 ---
 
 ## CLI Commands
@@ -255,7 +355,7 @@ Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
 ---
 
 <p align="center">
-  <strong>Your Claude Code. Your rules. Your way.</strong>
+  <strong>Your coding workflow. Your rules. Your way.</strong>
 </p>
 
 <p align="center">

package/dist/cli/index.js

@@ -12552,6 +12552,7 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} skipped ({{reason}})",
     "update.start": "Checking for updates...",
     "update.success": "Updated from {{from}} to {{to}}",
+    "update.components_synced": "Components synced (version {{version}}): {{components}}",
     "update.failed": "Update failed: {{error}}",
     "update.no_updates": "Already up to date",
     "update.backup_created": "Backup created at: {{path}}",
@@ -12583,6 +12584,7 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} 건너뜀 ({{reason}})",
     "update.start": "업데이트 확인 중...",
     "update.success": "{{from}}에서 {{to}}로 업데이트 완료",
+    "update.components_synced": "컴포넌트 동기화 완료 (버전 {{version}}): {{components}}",
     "update.failed": "업데이트 실패: {{error}}",
     "update.no_updates": "이미 최신 버전입니다",
     "update.backup_created": "백업 생성됨: {{path}}",
@@ -13515,7 +13517,7 @@ async function doctorCommand(options = {}) {
 }
 
 // src/cli/init.ts
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 
 // src/core/installer.ts
 import { readFile as fsReadFile, writeFile as fsWriteFile, rename } from "node:fs/promises";
@@ -13976,23 +13978,77 @@ async function backupExistingInstallation(targetDir, provider) {
   return backedUpPaths.length > 0 ? [backupDir] : [];
 }
 
+// src/core/mcp-config.ts
+import { execSync as execSync2 } from "node:child_process";
+import { writeFile } from "node:fs/promises";
+import { join as join5 } from "node:path";
+async function generateMCPConfig(targetDir, provider) {
+  const layout = getProviderLayout(provider);
+  const mcpConfigPath = join5(targetDir, ".mcp.json");
+  const ontologyDir = join5(layout.rootDir, "ontology");
+  const ontologyExists = await fileExists(join5(targetDir, ontologyDir));
+  if (!ontologyExists) {
+    return;
+  }
+  const config = {
+    mcpServers: {
+      "ontology-rag": {
+        type: "stdio",
+        command: "python",
+        args: ["-m", "ontology_rag.mcp_server"],
+        env: {
+          ONTOLOGY_DIR: ontologyDir
+        }
+      }
+    }
+  };
+  const existingConfigPath = mcpConfigPath;
+  if (await fileExists(existingConfigPath)) {
+    try {
+      const { readFile } = await import("node:fs/promises");
+      const existingContent = await readFile(existingConfigPath, "utf-8");
+      const existing = JSON.parse(existingContent);
+      if (!existing.mcpServers?.["ontology-rag"]) {
+        existing.mcpServers = existing.mcpServers || {};
+        existing.mcpServers["ontology-rag"] = config.mcpServers["ontology-rag"];
+        await writeFile(mcpConfigPath, `${JSON.stringify(existing, null, 2)}
+`);
+      }
+    } catch {
+      await writeFile(mcpConfigPath, `${JSON.stringify(config, null, 2)}
+`);
+    }
+  } else {
+    await writeFile(mcpConfigPath, `${JSON.stringify(config, null, 2)}
+`);
+  }
+}
+async function checkPythonAvailable() {
+  try {
+    execSync2("python --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/cli/init.ts
 async function checkExistingInstallation(targetDir, provider) {
   const layout = getProviderLayout(provider);
-  const rootDir = join5(targetDir, layout.rootDir);
+  const rootDir = join6(targetDir, layout.rootDir);
   return fileExists(rootDir);
 }
 var PROVIDER_SUBDIR_COMPONENTS = new Set(["rules", "hooks", "contexts", "agents", "skills"]);
 function componentToPath(targetDir, provider, component) {
   if (component === "entry-md") {
     const layout = getProviderLayout(provider);
-    return join5(targetDir, layout.entryFile);
+    return join6(targetDir, layout.entryFile);
   }
   if (PROVIDER_SUBDIR_COMPONENTS.has(component)) {
     const layout = getProviderLayout(provider);
-    return join5(targetDir, layout.rootDir, component);
+    return join6(targetDir, layout.rootDir, component);
   }
-  return join5(targetDir, component);
+  return join6(targetDir, component);
 }
 function buildInstalledPaths(targetDir, provider, components) {
   return components.map((component) => componentToPath(targetDir, provider, component));
@@ -14050,6 +14106,17 @@ async function initCommand(options) {
     const installedPaths = buildInstalledPaths(targetDir, provider, installResult.installedComponents);
     logInstallResultInfo(installResult);
     logSuccessDetails(installedPaths, installResult.skippedComponents);
+    const pythonAvailable = await checkPythonAvailable();
+    if (pythonAvailable) {
+      try {
+        await generateMCPConfig(targetDir, provider);
+      } catch {
+        console.warn("Warning: Failed to generate MCP config. You can configure it manually.");
+      }
+    } else {
+      console.warn("Warning: Python not found. Skipping MCP server configuration.");
+      console.warn("Install Python 3.10+ and ontology-rag to enable MCP integration.");
+    }
     return {
       success: true,
       message: i18n.t("cli.init.success"),
@@ -14063,7 +14130,7 @@ async function initCommand(options) {
 }
 
 // src/cli/list.ts
-import { basename as basename2, dirname as dirname2, join as join6, relative as relative2 } from "node:path";
+import { basename as basename2, dirname as dirname2, join as join7, relative as relative2 } from "node:path";
 var ALLOWED_TOP_LEVEL_KEYS = new Set(["name", "type", "description", "version", "category"]);
 function parseKeyValue(line) {
   const colonIndex = line.indexOf(":");
@@ -14127,12 +14194,12 @@ function extractAgentTypeFromFilename(filename) {
   return prefixMap[prefix] || "unknown";
 }
 function extractSkillCategoryFromPath(skillPath, baseDir, rootDir) {
-  const relativePath = relative2(join6(baseDir, rootDir, "skills"), skillPath);
+  const relativePath = relative2(join7(baseDir, rootDir, "skills"), skillPath);
   const parts = relativePath.split("/").filter(Boolean);
   return parts[0] || "unknown";
 }
 function extractGuideCategoryFromPath(guidePath, baseDir) {
-  const relativePath = relative2(join6(baseDir, "guides"), guidePath);
+  const relativePath = relative2(join7(baseDir, "guides"), guidePath);
   const parts = relativePath.split("/").filter(Boolean);
   return parts[0] || "unknown";
 }
@@ -14226,7 +14293,7 @@ async function tryExtractMarkdownDescription(mdPath, options = {}) {
   }
 }
 async function getAgents(targetDir, rootDir = ".claude", config) {
-  const agentsDir = join6(targetDir, rootDir, "agents");
+  const agentsDir = join7(targetDir, rootDir, "agents");
   if (!await fileExists(agentsDir))
     return [];
   try {
@@ -14254,7 +14321,7 @@ async function getAgents(targetDir, rootDir = ".claude", config) {
   }
 }
 async function getSkills(targetDir, rootDir = ".claude", config) {
-  const skillsDir = join6(targetDir, rootDir, "skills");
+  const skillsDir = join7(targetDir, rootDir, "skills");
   if (!await fileExists(skillsDir))
     return [];
   try {
@@ -14264,7 +14331,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 = dirname2(skillMdPath);
-      const indexYamlPath = join6(skillDir, "index.yaml");
+      const indexYamlPath = join7(skillDir, "index.yaml");
       const { description, version } = await tryReadIndexYamlMetadata(indexYamlPath);
       const relativePath = relative2(targetDir, skillDir);
       return {
@@ -14283,7 +14350,7 @@ async function getSkills(targetDir, rootDir = ".claude", config) {
   }
 }
 async function getGuides(targetDir, config) {
-  const guidesDir = join6(targetDir, "guides");
+  const guidesDir = join7(targetDir, "guides");
   if (!await fileExists(guidesDir))
     return [];
   try {
@@ -14310,7 +14377,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 = join6(targetDir, rootDir, "rules");
+  const rulesDir = join7(targetDir, rootDir, "rules");
   if (!await fileExists(rulesDir))
     return [];
   try {
@@ -14382,7 +14449,7 @@ function formatAsJson(components) {
   console.log(JSON.stringify(components, null, 2));
 }
 async function getHooks(targetDir, rootDir = ".claude") {
-  const hooksDir = join6(targetDir, rootDir, "hooks");
+  const hooksDir = join7(targetDir, rootDir, "hooks");
   if (!await fileExists(hooksDir))
     return [];
   try {
@@ -14400,7 +14467,7 @@ async function getHooks(targetDir, rootDir = ".claude") {
   }
 }
 async function getContexts(targetDir, rootDir = ".claude") {
-  const contextsDir = join6(targetDir, rootDir, "contexts");
+  const contextsDir = join7(targetDir, rootDir, "contexts");
   if (!await fileExists(contextsDir))
     return [];
   try {
@@ -14485,7 +14552,7 @@ async function listCommand(type = "all", options = {}) {
 }
 
 // src/core/updater.ts
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 
 // src/core/entry-merger.ts
 var MANAGED_START = "<!-- omcustom:start -->";
@@ -14737,7 +14804,7 @@ function resolveCustomizations(customizations, configPreserveFiles, targetDir) {
 }
 async function updateEntryDoc(targetDir, provider, config, options) {
   const layout = getProviderLayout(provider);
-  const entryPath = join7(targetDir, layout.entryFile);
+  const entryPath = join8(targetDir, layout.entryFile);
   const templateName = getEntryTemplateName2(provider, config.language);
   const templatePath = resolveTemplatePath(templateName);
   if (!await fileExists(templatePath)) {
@@ -14798,7 +14865,14 @@ async function update(options) {
     config.lastUpdated = new Date().toISOString();
     await saveConfig(options.targetDir, config);
     result.success = true;
-    success("update.success", { from: result.previousVersion, to: result.newVersion });
+    if (result.previousVersion !== result.newVersion) {
+      success("update.success", { from: result.previousVersion, to: result.newVersion });
+    } else if (result.updatedComponents.length > 0) {
+      success("update.components_synced", {
+        version: result.newVersion,
+        components: result.updatedComponents.join(", ")
+      });
+    }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     result.error = message;
@@ -14853,7 +14927,7 @@ async function updateComponent(targetDir, provider, component, customizations, o
   const preservedFiles = [];
   const componentPath = getComponentPath2(provider, component);
   const srcPath = resolveTemplatePath(componentPath);
-  const destPath = join7(targetDir, componentPath);
+  const destPath = join8(targetDir, componentPath);
   const customComponents = config.customComponents || [];
   const skipPaths = [];
   if (customizations && !options.forceOverwriteAll) {
@@ -14867,7 +14941,7 @@ async function updateComponent(targetDir, provider, component, customizations, o
     }
   }
   const path2 = await import("node:path");
-  const normalizedSkipPaths = skipPaths.map((p) => path2.relative(destPath, join7(targetDir, p)));
+  const normalizedSkipPaths = skipPaths.map((p) => path2.relative(destPath, join8(targetDir, p)));
   await copyDirectory(srcPath, destPath, {
     overwrite: true,
     skipPaths: normalizedSkipPaths.length > 0 ? normalizedSkipPaths : undefined
@@ -14887,26 +14961,26 @@ function getComponentPath2(provider, component) {
 }
 async function backupInstallation(targetDir, provider) {
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const backupDir = join7(targetDir, `.omcustom-backup-${timestamp}`);
+  const backupDir = join8(targetDir, `.omcustom-backup-${timestamp}`);
   const fs2 = await import("node:fs/promises");
   await ensureDirectory(backupDir);
   const layout = getProviderLayout(provider);
   const dirsToBackup = [layout.rootDir, "guides"];
   for (const dir2 of dirsToBackup) {
-    const srcPath = join7(targetDir, dir2);
+    const srcPath = join8(targetDir, dir2);
     if (await fileExists(srcPath)) {
-      const destPath = join7(backupDir, dir2);
+      const destPath = join8(backupDir, dir2);
       await copyDirectory(srcPath, destPath, { overwrite: true });
     }
   }
-  const entryPath = join7(targetDir, layout.entryFile);
+  const entryPath = join8(targetDir, layout.entryFile);
   if (await fileExists(entryPath)) {
-    await fs2.copyFile(entryPath, join7(backupDir, layout.entryFile));
+    await fs2.copyFile(entryPath, join8(backupDir, layout.entryFile));
   }
   return backupDir;
 }
 async function loadCustomizationManifest(targetDir) {
-  const manifestPath = join7(targetDir, CUSTOMIZATION_MANIFEST_FILE);
+  const manifestPath = join8(targetDir, CUSTOMIZATION_MANIFEST_FILE);
   if (await fileExists(manifestPath)) {
     return readJsonFile(manifestPath);
   }

package/dist/index.js

@@ -238,6 +238,7 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} skipped ({{reason}})",
     "update.start": "Checking for updates...",
     "update.success": "Updated from {{from}} to {{to}}",
+    "update.components_synced": "Components synced (version {{version}}): {{components}}",
     "update.failed": "Update failed: {{error}}",
     "update.no_updates": "Already up to date",
     "update.backup_created": "Backup created at: {{path}}",
@@ -269,6 +270,7 @@ var MESSAGES = {
     "install.entry_md_skipped": "{{entry}} 건너뜀 ({{reason}})",
     "update.start": "업데이트 확인 중...",
     "update.success": "{{from}}에서 {{to}}로 업데이트 완료",
+    "update.components_synced": "컴포넌트 동기화 완료 (버전 {{version}}): {{components}}",
     "update.failed": "업데이트 실패: {{error}}",
     "update.no_updates": "이미 최신 버전입니다",
     "update.backup_created": "백업 생성됨: {{path}}",
@@ -1508,7 +1510,14 @@ async function update(options) {
     config.lastUpdated = new Date().toISOString();
     await saveConfig(options.targetDir, config);
     result.success = true;
-    success("update.success", { from: result.previousVersion, to: result.newVersion });
+    if (result.previousVersion !== result.newVersion) {
+      success("update.success", { from: result.previousVersion, to: result.newVersion });
+    } else if (result.updatedComponents.length > 0) {
+      success("update.components_synced", {
+        version: result.newVersion,
+        components: result.updatedComponents.join(", ")
+      });
+    }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     result.error = message;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "oh-my-customcode",
-  "version": "0.10.3",
-  "description": "Batteries-included agent harness for Claude Code",
+  "version": "0.12.0",
+  "description": "Batteries-included agent harness for Claude Code and OpenAI Codex",
   "type": "module",
   "bin": {
     "omcustom": "./dist/cli/index.js"
@@ -59,6 +59,9 @@
   "keywords": [
     "claude",
     "claude-code",
+    "codex",
+    "codex-cli",
+    "openai",
     "ai",
     "agent",
     "cli"