@lgcyaxi/oh-my-claude 1.0.0 → 1.0.1

package/dist/index.js

@@ -1,9 +1,11 @@
 import {
   AgentConfigSchema,
+  AgentFallbackConfigSchema,
   AnthropicCompatibleClient,
   CategoryConfigSchema,
   ConcurrencyConfigSchema,
   DEFAULT_CONFIG,
+  FallbackRequiredError,
   OhMyClaudeConfigSchema,
   OpenAICompatibleClient,
   OpenRouterClient,
@@ -25,6 +27,7 @@ import {
   generateAgentMarkdown,
   generateAllAgentFiles,
   getAgent,
+  getAgentFallback,
   getAgentsDirectory,
   getCommandsDir,
   getConfigPath,
@@ -38,6 +41,7 @@ import {
   getProvidersStatus,
   install,
   isMcpAgent,
+  isProviderConfigured,
   isTaskAgent,
   librarianAgent,
   loadConfig,
@@ -50,10 +54,11 @@ import {
   resolveProviderForCategory,
   routeByAgent,
   routeByCategory,
+  shouldUseFallback,
   sisyphusAgent,
   taskAgents,
   uninstall
-} from "./index-ejmtq3zc.js";
+} from "./index-5ars1tn4.js";
 // src/providers/deepseek.ts
 var DEEPSEEK_BASE_URL = "https://api.deepseek.com/anthropic";
 var DEEPSEEK_API_KEY_ENV = "DEEPSEEK_API_KEY";
@@ -80,6 +85,7 @@ export {
   uninstall,
   taskAgents,
   sisyphusAgent,
+  shouldUseFallback,
   routeByCategory,
   routeByAgent,
   resolveProviderForCategory,
@@ -94,6 +100,7 @@ export {
   loadConfig,
   librarianAgent,
   isTaskAgent,
+  isProviderConfigured,
   isMcpAgent,
   install,
   getProvidersStatus,
@@ -107,6 +114,7 @@ export {
   getConfigPath,
   getCommandsDir,
   getAgentsDirectory,
+  getAgentFallback,
   getAgent,
   generateAllAgentFiles,
   generateAgentMarkdown,
@@ -131,9 +139,11 @@ export {
   OpenRouterClient,
   OpenAICompatibleClient,
   OhMyClaudeConfigSchema,
+  FallbackRequiredError,
   DEFAULT_CONFIG,
   ConcurrencyConfigSchema,
   CategoryConfigSchema,
   AnthropicCompatibleClient,
+  AgentFallbackConfigSchema,
   AgentConfigSchema
 };

package/dist/mcp/server.js

@@ -16671,6 +16671,11 @@ var ProviderConfigSchema = exports_external.object({
   api_key_env: exports_external.string().optional(),
   note: exports_external.string().optional()
 });
+var AgentFallbackConfigSchema = exports_external.object({
+  provider: exports_external.string(),
+  model: exports_external.string(),
+  executionMode: exports_external.enum(["task", "mcp"]).optional()
+});
 var AgentConfigSchema = exports_external.object({
   provider: exports_external.string(),
   model: exports_external.string(),
@@ -16679,7 +16684,8 @@ var AgentConfigSchema = exports_external.object({
   thinking: exports_external.object({
     enabled: exports_external.boolean(),
     budget_tokens: exports_external.number().optional()
-  }).optional()
+  }).optional(),
+  fallback: AgentFallbackConfigSchema.optional()
 });
 var CategoryConfigSchema = exports_external.object({
   provider: exports_external.string(),
@@ -16736,19 +16742,32 @@ var OhMyClaudeConfigSchema = exports_external.object({
     oracle: {
       provider: "deepseek",
       model: "deepseek-reasoner",
-      temperature: 0.1
+      temperature: 0.1,
+      fallback: { provider: "claude", model: "claude-opus-4-5", executionMode: "task" }
+    },
+    librarian: {
+      provider: "zhipu",
+      model: "glm-4.7",
+      temperature: 0.3,
+      fallback: { provider: "claude", model: "claude-sonnet-4-5", executionMode: "task" }
+    },
+    explore: {
+      provider: "deepseek",
+      model: "deepseek-chat",
+      temperature: 0.1,
+      fallback: { provider: "claude", model: "claude-haiku-4-5", executionMode: "task" }
     },
-    librarian: { provider: "zhipu", model: "glm-4.7", temperature: 0.3 },
-    explore: { provider: "deepseek", model: "deepseek-chat", temperature: 0.1 },
     "frontend-ui-ux": {
       provider: "zhipu",
       model: "glm-4v-flash",
-      temperature: 0.7
+      temperature: 0.7,
+      fallback: { provider: "claude", model: "claude-sonnet-4-5", executionMode: "task" }
     },
     "document-writer": {
       provider: "minimax",
       model: "MiniMax-M2.1",
-      temperature: 0.5
+      temperature: 0.5,
+      fallback: { provider: "claude", model: "claude-sonnet-4-5", executionMode: "task" }
     }
   }),
   categories: exports_external.record(exports_external.string(), CategoryConfigSchema).default({
@@ -16850,6 +16869,50 @@ function getProviderDetails(config2, providerName) {
   }
   return null;
 }
+function isProviderConfigured(config2, providerName) {
+  const providerConfig = config2.providers[providerName];
+  if (!providerConfig) {
+    return false;
+  }
+  if (providerConfig.type === "claude-subscription") {
+    return true;
+  }
+  if (providerConfig.api_key_env) {
+    const apiKey = process.env[providerConfig.api_key_env];
+    return !!apiKey && apiKey.length > 0;
+  }
+  return false;
+}
+function getAgentFallback(config2, agentName) {
+  const agentConfig = config2.agents[agentName];
+  if (agentConfig?.fallback) {
+    return {
+      provider: agentConfig.fallback.provider,
+      model: agentConfig.fallback.model,
+      executionMode: agentConfig.fallback.executionMode
+    };
+  }
+  return null;
+}
+function shouldUseFallback(config2, agentName) {
+  const agentConfig = config2.agents[agentName];
+  if (!agentConfig) {
+    return { useFallback: false };
+  }
+  if (!isProviderConfigured(config2, agentConfig.provider)) {
+    const fallback = getAgentFallback(config2, agentName);
+    if (fallback) {
+      const providerConfig = config2.providers[agentConfig.provider];
+      const envVar = providerConfig?.api_key_env ?? `${agentConfig.provider.toUpperCase()}_API_KEY`;
+      return {
+        useFallback: true,
+        reason: `${envVar} is not set`,
+        fallback
+      };
+    }
+  }
+  return { useFallback: false };
+}
 // src/providers/router.ts
 var clientCache = new Map;
 function getProviderClient(providerName, config2) {
@@ -16889,6 +16952,19 @@ function getProviderClient(providerName, config2) {
   clientCache.set(providerName, client);
   return client;
 }
+
+class FallbackRequiredError extends Error {
+  agentName;
+  fallback;
+  reason;
+  constructor(message, agentName, fallback, reason) {
+    super(message);
+    this.agentName = agentName;
+    this.fallback = fallback;
+    this.reason = reason;
+    this.name = "FallbackRequiredError";
+  }
+}
 async function routeByAgent(agentName, messages, options) {
   const config2 = loadConfig();
   const agentConfig = resolveProviderForAgent(config2, agentName);
@@ -16899,6 +16975,10 @@ async function routeByAgent(agentName, messages, options) {
   if (providerDetails?.type === "claude-subscription") {
     throw new Error(`Agent "${agentName}" uses Claude subscription. Use Claude Code's Task tool instead of MCP.`);
   }
+  const fallbackCheck = shouldUseFallback(config2, agentName);
+  if (fallbackCheck.useFallback && fallbackCheck.fallback) {
+    throw new FallbackRequiredError(`Agent "${agentName}" requires fallback: ${fallbackCheck.reason}. Use Task tool with ${fallbackCheck.fallback.model} instead.`, agentName, fallbackCheck.fallback, fallbackCheck.reason ?? "Provider not configured");
+  }
   const client = getProviderClient(agentConfig.provider, config2);
   const request = {
     model: agentConfig.model,
@@ -17903,7 +17983,12 @@ var oracleAgent = {
   defaultTemperature: 0.1,
   executionMode: "mcp",
   category: "advisor",
-  restrictedTools: ["Edit", "Write", "Task"]
+  restrictedTools: ["Edit", "Write", "Task"],
+  fallback: {
+    provider: "claude",
+    model: "claude-opus-4-5",
+    executionMode: "task"
+  }
 };
 // src/agents/librarian.ts
 var LIBRARIAN_PROMPT = `# THE LIBRARIAN
@@ -18109,7 +18194,12 @@ var librarianAgent = {
   defaultTemperature: 0.3,
   executionMode: "mcp",
   category: "explorer",
-  restrictedTools: ["Edit", "Write"]
+  restrictedTools: ["Edit", "Write"],
+  fallback: {
+    provider: "claude",
+    model: "claude-sonnet-4-5",
+    executionMode: "task"
+  }
 };
 // src/agents/explore.ts
 var EXPLORE_PROMPT = `You are a codebase search specialist. Your job: find files and code, return actionable results.
@@ -18212,7 +18302,12 @@ var exploreAgent = {
   defaultTemperature: 0.1,
   executionMode: "mcp",
   category: "explorer",
-  restrictedTools: ["Edit", "Write", "Task"]
+  restrictedTools: ["Edit", "Write", "Task"],
+  fallback: {
+    provider: "claude",
+    model: "claude-haiku-4-5",
+    executionMode: "task"
+  }
 };
 // src/agents/frontend-ui-ux.ts
 var FRONTEND_UI_UX_PROMPT = `# Role: Designer-Turned-Developer
@@ -18308,7 +18403,12 @@ var frontendUiUxAgent = {
   defaultModel: "glm-4v-flash",
   defaultTemperature: 0.7,
   executionMode: "mcp",
-  category: "specialist"
+  category: "specialist",
+  fallback: {
+    provider: "claude",
+    model: "claude-sonnet-4-5",
+    executionMode: "task"
+  }
 };
 // src/agents/document-writer.ts
 var DOCUMENT_WRITER_PROMPT = `<role>
@@ -18449,7 +18549,12 @@ var documentWriterAgent = {
   defaultModel: "MiniMax-M2.1",
   defaultTemperature: 0.5,
   executionMode: "mcp",
-  category: "specialist"
+  category: "specialist",
+  fallback: {
+    provider: "claude",
+    model: "claude-sonnet-4-5",
+    executionMode: "task"
+  }
 };
 // src/agents/index.ts
 var agents = {
@@ -18529,8 +18634,19 @@ async function runTask(task, systemPrompt) {
     task.completedAt = Date.now();
     tasks.set(task.id, task);
   } catch (error2) {
-    task.status = "failed";
-    task.error = error2 instanceof Error ? error2.message : String(error2);
+    if (error2 instanceof FallbackRequiredError) {
+      task.status = "fallback_required";
+      task.error = error2.message;
+      task.fallback = {
+        provider: error2.fallback.provider,
+        model: error2.fallback.model,
+        executionMode: error2.fallback.executionMode,
+        reason: error2.reason
+      };
+    } else {
+      task.status = "failed";
+      task.error = error2 instanceof Error ? error2.message : String(error2);
+    }
     task.completedAt = Date.now();
     tasks.set(task.id, task);
   }
@@ -18543,7 +18659,8 @@ function pollTask(taskId) {
   return {
     status: task.status,
     result: task.result,
-    error: task.error
+    error: task.error,
+    fallback: task.fallback
   };
 }
 function cancelTask(taskId) {
@@ -18643,6 +18760,9 @@ Use this for async operations that should run in parallel without blocking.
 - visual-engineering: UI/UX work
 - writing: Documentation and text
 
+**Fallback Behavior**:
+If the provider's API key is not configured, the task will return with status "fallback_required" and include fallback info. When this happens, use Claude Code's Task tool with the specified fallback model instead.
+
 Note: Agents using Claude subscription (sisyphus, claude-reviewer, claude-scout) should use Claude Code's Task tool instead.`,
     inputSchema: {
       type: "object",
@@ -18706,8 +18826,8 @@ Note: Agents using Claude subscription (sisyphus, claude-reviewer, claude-scout)
       properties: {
         status: {
           type: "string",
-          enum: ["pending", "running", "completed", "failed", "cancelled"],
-          description: "Filter by status"
+          enum: ["pending", "running", "completed", "failed", "cancelled", "fallback_required"],
+          description: "Filter by status. 'fallback_required' means the provider API key is not configured and Claude Task tool should be used instead."
         },
         limit: {
           type: "number",
@@ -18870,7 +18990,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                   ...t.completedAt && {
                     completed: new Date(t.completedAt).toISOString()
                   },
-                  ...t.error && { error: t.error }
+                  ...t.error && { error: t.error },
+                  ...t.fallback && { fallback: t.fallback }
                 }))
               })
             }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@lgcyaxi/oh-my-claude",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Multi-agent orchestration plugin for Claude Code with multi-provider support",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "oh-my-claude": "./bin/oh-my-claude.js"
+    "oh-my-claude": "bin/oh-my-claude.js"
   },
   "scripts": {
     "build": "bun build src/index.ts src/cli.ts --outdir dist --target node --splitting",
@@ -43,7 +43,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/lgcyaxi/oh-my-claude"
+    "url": "git+https://github.com/lgcyaxi/oh-my-claude.git"
   },
   "homepage": "https://github.com/lgcyaxi/oh-my-claude#readme",
   "bugs": {

package/src/agents/document-writer.ts

@@ -146,6 +146,11 @@ export const documentWriterAgent: AgentDefinition = {
   defaultTemperature: 0.5,
   executionMode: "mcp",
   category: "specialist",
+  fallback: {
+    provider: "claude",
+    model: "claude-sonnet-4-5",
+    executionMode: "task",
+  },
 };
 
 export default documentWriterAgent;

package/src/agents/explore.ts

@@ -108,6 +108,11 @@ export const exploreAgent: AgentDefinition = {
   executionMode: "mcp",
   category: "explorer",
   restrictedTools: ["Edit", "Write", "Task"],
+  fallback: {
+    provider: "claude",
+    model: "claude-haiku-4-5",
+    executionMode: "task",
+  },
 };
 
 export default exploreAgent;

package/src/agents/frontend-ui-ux.ts

@@ -101,6 +101,11 @@ export const frontendUiUxAgent: AgentDefinition = {
   defaultTemperature: 0.7,
   executionMode: "mcp",
   category: "specialist",
+  fallback: {
+    provider: "claude",
+    model: "claude-sonnet-4-5",
+    executionMode: "task",
+  },
 };
 
 export default frontendUiUxAgent;

package/src/agents/librarian.ts

@@ -211,6 +211,11 @@ export const librarianAgent: AgentDefinition = {
   executionMode: "mcp",
   category: "explorer",
   restrictedTools: ["Edit", "Write"],
+  fallback: {
+    provider: "claude",
+    model: "claude-sonnet-4-5",
+    executionMode: "task",
+  },
 };
 
 export default librarianAgent;

package/src/agents/oracle.ts

@@ -99,6 +99,11 @@ export const oracleAgent: AgentDefinition = {
   executionMode: "mcp",
   category: "advisor",
   restrictedTools: ["Edit", "Write", "Task"],
+  fallback: {
+    provider: "claude",
+    model: "claude-opus-4-5",
+    executionMode: "task",
+  },
 };
 
 export default oracleAgent;

package/src/agents/types.ts

@@ -2,6 +2,15 @@
  * Agent definition types for oh-my-claude
  */
 
+export interface AgentFallback {
+  /** Fallback provider (usually "claude") */
+  provider: string;
+  /** Fallback model */
+  model: string;
+  /** Fallback execution mode (usually "task" for Claude) */
+  executionMode: "task" | "mcp";
+}
+
 export interface AgentDefinition {
   /** Agent identifier (used in config) */
   name: string;
@@ -21,6 +30,8 @@ export interface AgentDefinition {
   category: "orchestrator" | "reviewer" | "scout" | "advisor" | "explorer" | "specialist" | "planner";
   /** Tools this agent should NOT use (restrictions) */
   restrictedTools?: string[];
+  /** Fallback configuration when primary provider API key is not available */
+  fallback?: AgentFallback;
 }
 
 export interface AgentMarkdownOptions {

package/src/cli.ts

@@ -7,6 +7,7 @@
  *   npx oh-my-claude uninstall   # Uninstall oh-my-claude
  *   npx oh-my-claude status      # Check installation status
  *   npx oh-my-claude doctor      # Diagnose configuration issues
+ *   npx oh-my-claude update      # Update oh-my-claude to latest version
  *   npx oh-my-claude setup-mcp   # Install official MCP servers (MiniMax, GLM)
  */
 
@@ -18,7 +19,7 @@ import { loadConfig } from "./config";
 program
   .name("oh-my-claude")
   .description("Multi-agent orchestration plugin for Claude Code")
-  .version("1.0.0");
+  .version("1.0.1");
 
 // Install command
 program
@@ -362,6 +363,130 @@ program
     }
   });
 
+// Update command
+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");
+
+    // Color helpers
+    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: string) => `${c.green}✓${c.reset} ${text}`;
+    const fail = (text: string) => `${c.red}✗${c.reset} ${text}`;
+    const warn = (text: string) => `${c.yellow}⚠${c.reset} ${text}`;
+    const header = (text: string) => `${c.cyan}${c.bold}${text}${c.reset}`;
+    const dimText = (text: string) => `${c.dim}${text}${c.reset}`;
+
+    const PACKAGE_NAME = "@lgcyaxi/oh-my-claude";
+
+    console.log(`${c.bold}${c.magenta}oh-my-claude Update${c.reset}\n`);
+
+    // Get current version
+    let currentVersion = "unknown";
+    try {
+      // Try to read from package.json in the installed location
+      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 {
+        // Fall back to the version from the running CLI
+        currentVersion = program.version() || "unknown";
+      }
+    } catch (error) {
+      // Use the CLI version as fallback
+      currentVersion = program.version() || "unknown";
+    }
+
+    console.log(`Current version: ${c.cyan}${currentVersion}${c.reset}`);
+
+    // Fetch latest version from npm
+    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}\n`);
+    } catch (error) {
+      console.log(`${fail("Failed to fetch latest version from npm")}`);
+      console.log(`${dimText("Check your internet connection or try again later")}\n`);
+      process.exit(1);
+    }
+
+    // Compare versions
+    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(`\nRun ${c.cyan}npx ${PACKAGE_NAME} update${c.reset} to update.`);
+      }
+      process.exit(0);
+    }
+
+    // Perform update
+    console.log(header("Updating oh-my-claude...\n"));
+
+    try {
+      // Step 1: Clear npx cache for the package
+      console.log(`${dimText("Clearing npx cache...")}`);
+      try {
+        execSync(`npx --yes clear-npx-cache 2>/dev/null || true`, { stdio: "pipe" });
+      } catch {
+        // Ignore errors - cache clear is optional
+      }
+
+      // Step 2: Install latest version via npx
+      console.log(`${dimText("Downloading latest version...")}`);
+
+      // Use npx with --yes to ensure latest version is fetched
+      // The @latest tag forces npm to check for the newest version
+      const updateCmd = `npx --yes ${PACKAGE_NAME}@latest install --force`;
+      console.log(`${dimText(`Running: ${updateCmd}`)}\n`);
+
+      execSync(updateCmd, { stdio: "inherit" });
+
+      console.log(`\n${ok("Update complete!")}`);
+      console.log(`Updated from ${c.yellow}${currentVersion}${c.reset} to ${c.green}${latestVersion}${c.reset}`);
+
+      // Show changelog hint
+      console.log(`\n${dimText("View changelog at: https://github.com/lgcyaxi/oh-my-claude/blob/main/CHANGELOG.md")}`);
+
+    } catch (error) {
+      console.log(`\n${fail("Update failed")}`);
+      console.log(`${dimText("Try running manually:")}`);
+      console.log(`  ${c.cyan}npx ${PACKAGE_NAME}@latest install --force${c.reset}`);
+      process.exit(1);
+    }
+  });
+
 // Setup MCP command
 program
   .command("setup-mcp")

package/src/config/loader.ts

@@ -103,3 +103,76 @@ export function getProviderDetails(
   }
   return null;
 }
+
+/**
+ * Check if a provider is configured (has API key set)
+ */
+export function isProviderConfigured(
+  config: OhMyClaudeConfig,
+  providerName: string
+): boolean {
+  const providerConfig = config.providers[providerName];
+  if (!providerConfig) {
+    return false;
+  }
+
+  // Claude subscription is always "configured"
+  if (providerConfig.type === "claude-subscription") {
+    return true;
+  }
+
+  // Check if API key environment variable is set
+  if (providerConfig.api_key_env) {
+    const apiKey = process.env[providerConfig.api_key_env];
+    return !!apiKey && apiKey.length > 0;
+  }
+
+  return false;
+}
+
+/**
+ * Get fallback configuration for an agent
+ */
+export function getAgentFallback(
+  config: OhMyClaudeConfig,
+  agentName: string
+): { provider: string; model: string; executionMode?: string } | null {
+  const agentConfig = config.agents[agentName];
+  if (agentConfig?.fallback) {
+    return {
+      provider: agentConfig.fallback.provider,
+      model: agentConfig.fallback.model,
+      executionMode: agentConfig.fallback.executionMode,
+    };
+  }
+  return null;
+}
+
+/**
+ * Check if an agent should use fallback (primary provider not configured)
+ */
+export function shouldUseFallback(
+  config: OhMyClaudeConfig,
+  agentName: string
+): { useFallback: boolean; reason?: string; fallback?: { provider: string; model: string; executionMode?: string } } {
+  const agentConfig = config.agents[agentName];
+  if (!agentConfig) {
+    return { useFallback: false };
+  }
+
+  // Check if primary provider is configured
+  if (!isProviderConfigured(config, agentConfig.provider)) {
+    const fallback = getAgentFallback(config, agentName);
+    if (fallback) {
+      const providerConfig = config.providers[agentConfig.provider];
+      const envVar = providerConfig?.api_key_env ?? `${agentConfig.provider.toUpperCase()}_API_KEY`;
+      return {
+        useFallback: true,
+        reason: `${envVar} is not set`,
+        fallback,
+      };
+    }
+  }
+
+  return { useFallback: false };
+}