@lgcyaxi/oh-my-claude 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Individual version changelogs are available in the [changelog/](./changelog/) directory.
+
+## [1.0.1] - 2025-01-15
+
+See [changelog/v1.0.1.md](./changelog/v1.0.1.md) for details.
+
+### Added
+- Self-update command (`update`)
+- Automatic fallback to Claude models when API keys not configured
+
+### Fixed
+- Windows ESM path compatibility
+
+## [1.0.0] - 2025-01-15
+
+See [changelog/v1.0.0.md](./changelog/v1.0.0.md) for details.
+
+### Added
+- Initial release
+- Multi-provider MCP server (DeepSeek, ZhiPu GLM, MiniMax)
+- Specialized agent workflows
+- Slash commands and CLI tools
+- Planning system with Prometheus
+- Hook integration

package/README.md

@@ -101,17 +101,29 @@ npx @lgcyaxi/oh-my-claude doctor --detail
 
 ## Agent Workflows
 
-| Agent | Provider | Model | Role |
-|-------|----------|-------|------|
-| **Sisyphus** | Claude (Task tool) | claude-opus-4-5 | Primary orchestrator |
-| **Claude-Reviewer** | Claude (Task tool) | claude-sonnet-4-5 | Code review, QA |
-| **Claude-Scout** | Claude (Task tool) | claude-haiku-4-5 | Fast exploration |
-| **Prometheus** | Claude (Task tool) | claude-opus-4-5 | Strategic planning |
-| **Oracle** | DeepSeek (MCP) | deepseek-reasoner | Deep reasoning |
-| **Librarian** | ZhiPu (MCP) | glm-4.7 | External research |
-| **Explore** | DeepSeek (MCP) | deepseek-chat | Codebase search |
-| **Frontend-UI-UX** | ZhiPu (MCP) | glm-4v-flash | Visual/UI design |
-| **Document-Writer** | MiniMax (MCP) | MiniMax-M2.1 | Documentation |
+| Agent | Provider | Model | Role | Fallback |
+|-------|----------|-------|------|----------|
+| **Sisyphus** | Claude (Task tool) | claude-opus-4-5 | Primary orchestrator | - |
+| **Claude-Reviewer** | Claude (Task tool) | claude-sonnet-4-5 | Code review, QA | - |
+| **Claude-Scout** | Claude (Task tool) | claude-haiku-4-5 | Fast exploration | - |
+| **Prometheus** | Claude (Task tool) | claude-opus-4-5 | Strategic planning | - |
+| **Oracle** | DeepSeek (MCP) | deepseek-reasoner | Deep reasoning | claude-opus-4-5 |
+| **Librarian** | ZhiPu (MCP) | glm-4.7 | External research | claude-sonnet-4-5 |
+| **Explore** | DeepSeek (MCP) | deepseek-chat | Codebase search | claude-haiku-4-5 |
+| **Frontend-UI-UX** | ZhiPu (MCP) | glm-4v-flash | Visual/UI design | claude-sonnet-4-5 |
+| **Document-Writer** | MiniMax (MCP) | MiniMax-M2.1 | Documentation | claude-sonnet-4-5 |
+
+### Automatic Fallback
+
+MCP agents automatically fall back to Claude models when the provider's API key is not configured:
+
+- **Oracle** → `claude-opus-4-5` (preserves deep reasoning capability)
+- **Librarian** → `claude-sonnet-4-5` (balanced research capability)
+- **Explore** → `claude-haiku-4-5` (fast search operations)
+- **Frontend-UI-UX** → `claude-sonnet-4-5` (quality visual design)
+- **Document-Writer** → `claude-sonnet-4-5` (quality documentation)
+
+This allows oh-my-claude to work with Claude Code's subscription even without external API keys.
 
 ## Official MCP Servers
 
@@ -134,6 +146,11 @@ npx @lgcyaxi/oh-my-claude install              # Install oh-my-claude
 npx @lgcyaxi/oh-my-claude install --force      # Force reinstall
 npx @lgcyaxi/oh-my-claude install --skip-mcp   # Skip MCP server setup
 
+# Update
+npx @lgcyaxi/oh-my-claude update               # Update to latest version
+npx @lgcyaxi/oh-my-claude update --check       # Check for updates only
+npx @lgcyaxi/oh-my-claude update --force       # Force reinstall latest
+
 # Status & Diagnostics
 npx @lgcyaxi/oh-my-claude status               # Check installation status
 npx @lgcyaxi/oh-my-claude doctor               # Diagnose configuration

package/README.zh-CN.md

@@ -101,17 +101,29 @@ npx @lgcyaxi/oh-my-claude doctor --detail
 
 ## 智能体工作流
 
-| 智能体 | 供应商 | 模型 | 角色 |
-|--------|--------|------|------|
-| **Sisyphus** | Claude（Task 工具）| claude-opus-4-5 | 主编排器 |
-| **Claude-Reviewer** | Claude（Task 工具）| claude-sonnet-4-5 | 代码审查、质量保证 |
-| **Claude-Scout** | Claude（Task 工具）| claude-haiku-4-5 | 快速探索 |
-| **Prometheus** | Claude（Task 工具）| claude-opus-4-5 | 战略规划 |
-| **Oracle** | DeepSeek（MCP）| deepseek-reasoner | 深度推理 |
-| **Librarian** | 智谱（MCP）| glm-4.7 | 外部研究 |
-| **Explore** | DeepSeek（MCP）| deepseek-chat | 代码库搜索 |
-| **Frontend-UI-UX** | 智谱（MCP）| glm-4v-flash | 视觉/UI 设计 |
-| **Document-Writer** | MiniMax（MCP）| MiniMax-M2.1 | 文档编写 |
+| 智能体 | 供应商 | 模型 | 角色 | 降级模型 |
+|--------|--------|------|------|----------|
+| **Sisyphus** | Claude（Task 工具）| claude-opus-4-5 | 主编排器 | - |
+| **Claude-Reviewer** | Claude（Task 工具）| claude-sonnet-4-5 | 代码审查、质量保证 | - |
+| **Claude-Scout** | Claude（Task 工具）| claude-haiku-4-5 | 快速探索 | - |
+| **Prometheus** | Claude（Task 工具）| claude-opus-4-5 | 战略规划 | - |
+| **Oracle** | DeepSeek（MCP）| deepseek-reasoner | 深度推理 | claude-opus-4-5 |
+| **Librarian** | 智谱（MCP）| glm-4.7 | 外部研究 | claude-sonnet-4-5 |
+| **Explore** | DeepSeek（MCP）| deepseek-chat | 代码库搜索 | claude-haiku-4-5 |
+| **Frontend-UI-UX** | 智谱（MCP）| glm-4v-flash | 视觉/UI 设计 | claude-sonnet-4-5 |
+| **Document-Writer** | MiniMax（MCP）| MiniMax-M2.1 | 文档编写 | claude-sonnet-4-5 |
+
+### 自动降级
+
+当供应商的 API 密钥未配置时，MCP 智能体会自动降级到 Claude 模型：
+
+- **Oracle** → `claude-opus-4-5`（保持深度推理能力）
+- **Librarian** → `claude-sonnet-4-5`（平衡的研究能力）
+- **Explore** → `claude-haiku-4-5`（快速搜索操作）
+- **Frontend-UI-UX** → `claude-sonnet-4-5`（优质视觉设计）
+- **Document-Writer** → `claude-sonnet-4-5`（优质文档编写）
+
+这使得 oh-my-claude 即使没有外部 API 密钥也能通过 Claude Code 订阅正常工作。
 
 ## 官方 MCP 服务
 
@@ -134,6 +146,11 @@ npx @lgcyaxi/oh-my-claude install              # 安装 oh-my-claude
 npx @lgcyaxi/oh-my-claude install --force      # 强制重新安装
 npx @lgcyaxi/oh-my-claude install --skip-mcp   # 跳过 MCP 服务设置
 
+# 更新
+npx @lgcyaxi/oh-my-claude update               # 更新到最新版本
+npx @lgcyaxi/oh-my-claude update --check       # 仅检查更新
+npx @lgcyaxi/oh-my-claude update --force       # 强制重新安装最新版
+
 # 状态和诊断
 npx @lgcyaxi/oh-my-claude status               # 检查安装状态
 npx @lgcyaxi/oh-my-claude doctor               # 诊断配置

package/bin/oh-my-claude.js

@@ -8,7 +8,7 @@
 
 import { existsSync } from "node:fs";
 import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const distCli = join(__dirname, "..", "dist", "cli.js");
@@ -17,7 +17,9 @@ const srcCli = join(__dirname, "..", "src", "cli.ts");
 async function main() {
   if (existsSync(distCli)) {
     // Use compiled version
-    await import(distCli);
+    // Convert to file:// URL for Windows compatibility
+    const distCliUrl = pathToFileURL(distCli).href;
+    await import(distCliUrl);
   } else if (existsSync(srcCli)) {
     // Fall back to source (requires Bun)
     const { spawn } = await import("node:child_process");

package/changelog/v1.0.0.md

@@ -0,0 +1,28 @@
+# v1.0.0 - 2025-01-15
+
+Initial release of oh-my-claude.
+
+## Added
+
+- **Multi-provider MCP server** supporting DeepSeek, ZhiPu GLM, and MiniMax via Anthropic-compatible APIs
+- **Specialized agent workflows**:
+  - Sisyphus - Primary orchestrator (Claude Opus 4.5)
+  - Claude-Reviewer - Code review and QA (Claude Sonnet 4.5)
+  - Claude-Scout - Fast exploration (Claude Haiku 4.5)
+  - Prometheus - Strategic planning (Claude Opus 4.5)
+  - Oracle - Deep reasoning (DeepSeek reasoner)
+  - Librarian - External research (ZhiPu GLM)
+  - Explore - Codebase search (DeepSeek chat)
+  - Frontend-UI-UX - Visual/UI design (ZhiPu GLM-4v)
+  - Document-Writer - Documentation (MiniMax)
+- **Slash commands**:
+  - Agent commands: `/omc-sisyphus`, `/omc-oracle`, `/omc-librarian`, `/omc-reviewer`, `/omc-scout`, `/omc-explore`, `/omc-plan`, `/omc-start-work`
+  - Quick actions: `/omcx-commit`, `/omcx-implement`, `/omcx-refactor`, `/omcx-docs`
+- **CLI commands**:
+  - `install` - Install oh-my-claude into Claude Code
+  - `uninstall` - Remove oh-my-claude
+  - `status` - Check installation status
+  - `doctor` - Diagnose configuration with detailed component status
+  - `setup-mcp` - Install official MCP servers (Sequential Thinking, MiniMax, GLM)
+- **Hook integration** for code quality checks and todo tracking
+- **Concurrent execution** with per-provider rate limiting

package/changelog/v1.0.1.md

@@ -0,0 +1,28 @@
+# v1.0.1 - 2025-01-15
+
+Patch release with Windows fix, self-update command, and automatic fallback support.
+
+## Added
+
+- **Self-update command**: `npx @lgcyaxi/oh-my-claude update`
+  - Check current vs latest version from npm registry
+  - `--check` option to only check for updates without installing
+  - `--force` option to force reinstall even if already on latest version
+  - Automatically clears npx cache and runs install with @latest tag
+
+- **Automatic fallback to Claude models**: MCP agents now automatically fall back to Claude models via Task tool when their provider's API key is not configured:
+  | Agent | Primary Provider | Fallback Model |
+  |-------|-----------------|----------------|
+  | Oracle | DeepSeek | claude-opus-4-5 |
+  | Librarian | ZhiPu | claude-sonnet-4-5 |
+  | Explore | DeepSeek | claude-haiku-4-5 |
+  | Frontend-UI-UX | ZhiPu | claude-sonnet-4-5 |
+  | Document-Writer | MiniMax | claude-sonnet-4-5 |
+
+  This allows oh-my-claude to work with Claude Code's subscription even without external API keys.
+
+## Fixed
+
+- **Windows compatibility**: Fixed `ERR_UNSUPPORTED_ESM_URL_SCHEME` error on Windows
+  - Used `pathToFileURL()` for dynamic imports in bin/oh-my-claude.js
+  - Converts paths like `C:\...` to proper `file:///C:/...` URLs

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   install,
   loadConfig,
   uninstall
-} from "./index-ejmtq3zc.js";
+} from "./index-5ars1tn4.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
@@ -2120,7 +2120,7 @@ var {
 } = import__.default;
 
 // src/cli.ts
-program.name("oh-my-claude").description("Multi-agent orchestration plugin for Claude Code").version("0.1.0");
+program.name("oh-my-claude").description("Multi-agent orchestration plugin for Claude Code").version("1.0.1");
 program.command("install").description("Install oh-my-claude into Claude Code").option("--skip-agents", "Skip agent file generation").option("--skip-hooks", "Skip hooks installation").option("--skip-mcp", "Skip MCP server installation").option("--force", "Force overwrite existing files").action(async (options) => {
   console.log(`Installing oh-my-claude...
 `);
@@ -2404,6 +2404,98 @@ ${header("Recommendations:")}`);
 ${dimText("Tip: Run 'oh-my-claude doctor --detail' for detailed component status")}`);
   }
 });
+program.command("update").description("Update oh-my-claude to the latest version").option("--check", "Only check for updates without installing").option("--force", "Force update even if already on latest version").action(async (options) => {
+  const { execSync } = __require("node:child_process");
+  const { readFileSync, existsSync } = __require("node:fs");
+  const { join } = __require("node:path");
+  const { homedir } = __require("node:os");
+  const useColor = process.stdout.isTTY;
+  const c = {
+    reset: useColor ? "\x1B[0m" : "",
+    bold: useColor ? "\x1B[1m" : "",
+    dim: useColor ? "\x1B[2m" : "",
+    green: useColor ? "\x1B[32m" : "",
+    red: useColor ? "\x1B[31m" : "",
+    yellow: useColor ? "\x1B[33m" : "",
+    cyan: useColor ? "\x1B[36m" : "",
+    magenta: useColor ? "\x1B[35m" : ""
+  };
+  const ok = (text) => `${c.green}✓${c.reset} ${text}`;
+  const fail = (text) => `${c.red}✗${c.reset} ${text}`;
+  const warn = (text) => `${c.yellow}⚠${c.reset} ${text}`;
+  const header = (text) => `${c.cyan}${c.bold}${text}${c.reset}`;
+  const dimText = (text) => `${c.dim}${text}${c.reset}`;
+  const PACKAGE_NAME = "@lgcyaxi/oh-my-claude";
+  console.log(`${c.bold}${c.magenta}oh-my-claude Update${c.reset}
+`);
+  let currentVersion = "unknown";
+  try {
+    const installDir = join(homedir(), ".claude", "oh-my-claude");
+    const localPkgPath = join(installDir, "package.json");
+    if (existsSync(localPkgPath)) {
+      const pkg = JSON.parse(readFileSync(localPkgPath, "utf-8"));
+      currentVersion = pkg.version;
+    } else {
+      currentVersion = program.version() || "unknown";
+    }
+  } catch (error) {
+    currentVersion = program.version() || "unknown";
+  }
+  console.log(`Current version: ${c.cyan}${currentVersion}${c.reset}`);
+  let latestVersion = "unknown";
+  try {
+    console.log(`${dimText("Checking npm registry for latest version...")}`);
+    const npmInfo = execSync(`npm view ${PACKAGE_NAME} version 2>/dev/null`, {
+      encoding: "utf-8"
+    }).trim();
+    latestVersion = npmInfo;
+    console.log(`Latest version:  ${c.cyan}${latestVersion}${c.reset}
+`);
+  } catch (error) {
+    console.log(`${fail("Failed to fetch latest version from npm")}`);
+    console.log(`${dimText("Check your internet connection or try again later")}
+`);
+    process.exit(1);
+  }
+  const isUpToDate = currentVersion === latestVersion;
+  const needsUpdate = !isUpToDate || options.force;
+  if (isUpToDate && !options.force) {
+    console.log(ok("You are already on the latest version!"));
+    process.exit(0);
+  }
+  if (options.check) {
+    if (needsUpdate) {
+      console.log(warn(`Update available: ${currentVersion} → ${latestVersion}`));
+      console.log(`
+Run ${c.cyan}npx ${PACKAGE_NAME} update${c.reset} to update.`);
+    }
+    process.exit(0);
+  }
+  console.log(header(`Updating oh-my-claude...
+`));
+  try {
+    console.log(`${dimText("Clearing npx cache...")}`);
+    try {
+      execSync(`npx --yes clear-npx-cache 2>/dev/null || true`, { stdio: "pipe" });
+    } catch {}
+    console.log(`${dimText("Downloading latest version...")}`);
+    const updateCmd = `npx --yes ${PACKAGE_NAME}@latest install --force`;
+    console.log(`${dimText(`Running: ${updateCmd}`)}
+`);
+    execSync(updateCmd, { stdio: "inherit" });
+    console.log(`
+${ok("Update complete!")}`);
+    console.log(`Updated from ${c.yellow}${currentVersion}${c.reset} to ${c.green}${latestVersion}${c.reset}`);
+    console.log(`
+${dimText("View changelog at: https://github.com/lgcyaxi/oh-my-claude/blob/main/CHANGELOG.md")}`);
+  } catch (error) {
+    console.log(`
+${fail("Update failed")}`);
+    console.log(`${dimText("Try running manually:")}`);
+    console.log(`  ${c.cyan}npx ${PACKAGE_NAME}@latest install --force${c.reset}`);
+    process.exit(1);
+  }
+});
 program.command("setup-mcp").description("Install official MCP servers (MiniMax, GLM/ZhiPu)").option("--minimax", "Install MiniMax MCP only").option("--glm", "Install GLM/ZhiPu MCPs only").option("--thinking", "Install Sequential Thinking MCP only").option("--list", "List available MCP servers").action(async (options) => {
   const { execSync, spawnSync } = __require("node:child_process");
   const useColor = process.stdout.isTTY;