@lgcyaxi/oh-my-claude 1.0.0 → 1.1.1

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.1.1");
 
 // Install command
 program
@@ -205,6 +206,7 @@ program
     console.log(`  ${status.components.agents ? ok("Agent files generated") : fail("Agent files generated")}`);
     console.log(`  ${status.components.hooks ? ok("Hooks configured") : fail("Hooks configured")}`);
     console.log(`  ${status.components.mcp ? ok("MCP server configured") : fail("MCP server configured")}`);
+    console.log(`  ${status.components.statusLine ? ok("StatusLine configured") : warn("StatusLine not configured")}`);
     console.log(`  ${status.components.config ? ok("Configuration file exists") : fail("Configuration file exists")}`);
 
 
@@ -242,11 +244,13 @@ program
         "omc-explore",
         "omc-plan",
         "omc-start-work",
+        "omc-status",
         // Quick action commands
         "omcx-commit",
         "omcx-implement",
         "omcx-refactor",
         "omcx-docs",
+        "omcx-issue",
       ];
       console.log(`  ${subheader("Agent commands (omc-):")}`);
       for (const cmd of expectedCommands.filter(c => c.startsWith("omc-"))) {
@@ -290,12 +294,43 @@ program
       // Hooks detail
       console.log(`\n${header("Hooks (detailed):")}`);
       const hooksDir = join(homedir(), ".claude", "oh-my-claude", "hooks");
-      const expectedHooks = ["comment-checker.js", "todo-continuation.js"];
+      const expectedHooks = ["comment-checker.js", "todo-continuation.js", "task-notification.js"];
       for (const hook of expectedHooks) {
         const hookPath = join(hooksDir, hook);
         const exists = existsSync(hookPath);
         console.log(`  ${exists ? ok(hook) : fail(hook)}`);
       }
+
+      // StatusLine detail
+      console.log(`\n${header("StatusLine (detailed):")}`);
+      const statusLineDir = join(homedir(), ".claude", "oh-my-claude", "dist", "statusline");
+      const statusLineScript = join(statusLineDir, "statusline.js");
+      const statusFileExists = existsSync(statusLineScript);
+      console.log(`  ${statusFileExists ? ok("statusline.js installed") : fail("statusline.js not installed")}`);
+
+      try {
+        const settingsPath = join(homedir(), ".claude", "settings.json");
+        if (existsSync(settingsPath)) {
+          const settings = JSON.parse(require("node:fs").readFileSync(settingsPath, "utf-8"));
+          if (settings.statusLine) {
+            const cmd = settings.statusLine.command || "";
+            const isOurs = cmd.includes("oh-my-claude");
+            const isWrapper = cmd.includes("statusline-wrapper");
+            console.log(`  ${ok("StatusLine configured in settings.json")}`);
+            if (isWrapper) {
+              console.log(`    Mode: ${c.yellow}Merged (wrapper)${c.reset}`);
+            } else if (isOurs) {
+              console.log(`    Mode: ${c.green}Direct${c.reset}`);
+            } else {
+              console.log(`    Mode: ${c.cyan}External${c.reset}`);
+            }
+          } else {
+            console.log(`  ${warn("StatusLine not configured in settings.json")}`);
+          }
+        }
+      } catch {
+        console.log(`  ${fail("Failed to read settings.json")}`);
+      }
     }
 
     // Check providers
@@ -362,6 +397,230 @@ 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);
+    }
+  });
+
+// StatusLine command
+program
+  .command("statusline")
+  .description("Manage statusline integration")
+  .option("--enable", "Enable statusline")
+  .option("--disable", "Disable statusline")
+  .option("--status", "Show current statusline configuration")
+  .action((options) => {
+    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" : "",
+    };
+
+    const ok = (text: string) => `${c.green}+${c.reset} ${text}`;
+    const fail = (text: string) => `${c.red}x${c.reset} ${text}`;
+    const warn = (text: string) => `${c.yellow}!${c.reset} ${text}`;
+
+    const settingsPath = join(homedir(), ".claude", "settings.json");
+
+    if (options.status || (!options.enable && !options.disable)) {
+      // Show status
+      console.log(`${c.bold}StatusLine Status${c.reset}\n`);
+
+      if (!existsSync(settingsPath)) {
+        console.log(fail("settings.json not found"));
+        process.exit(1);
+      }
+
+      try {
+        const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+
+        if (!settings.statusLine) {
+          console.log(fail("StatusLine not configured"));
+          console.log(`\nRun ${c.cyan}oh-my-claude statusline --enable${c.reset} to enable.`);
+        } else {
+          const cmd = settings.statusLine.command || "";
+          const isOurs = cmd.includes("oh-my-claude");
+          const isWrapper = cmd.includes("statusline-wrapper");
+
+          console.log(ok("StatusLine configured"));
+          console.log(`  Command: ${c.dim}${cmd}${c.reset}`);
+
+          if (isWrapper) {
+            console.log(`  Mode: ${c.yellow}Merged (wrapper)${c.reset}`);
+          } else if (isOurs) {
+            console.log(`  Mode: ${c.green}Direct${c.reset}`);
+          } else {
+            console.log(`  Mode: ${c.cyan}External${c.reset}`);
+          }
+        }
+      } catch (error) {
+        console.log(fail(`Failed to read settings: ${error}`));
+        process.exit(1);
+      }
+    } else if (options.enable) {
+      // Enable statusline
+      const { installStatusLine } = require("./installer/settings-merger");
+      const { getStatusLineScriptPath } = require("./installer");
+
+      try {
+        const result = installStatusLine(getStatusLineScriptPath());
+        if (result.installed) {
+          console.log(ok("StatusLine enabled"));
+          if (result.wrapperCreated) {
+            console.log(warn("Wrapper created to merge with existing statusLine"));
+          }
+        }
+      } catch (error) {
+        console.log(fail(`Failed to enable statusline: ${error}`));
+        process.exit(1);
+      }
+    } else if (options.disable) {
+      // Disable statusline
+      const { uninstallStatusLine } = require("./installer/settings-merger");
+
+      try {
+        const result = uninstallStatusLine();
+        if (result) {
+          console.log(ok("StatusLine disabled"));
+        } else {
+          console.log(warn("StatusLine was not configured"));
+        }
+      } catch (error) {
+        console.log(fail(`Failed to disable statusline: ${error}`));
+        process.exit(1);
+      }
+    }
+  });
+
 // Setup MCP command
 program
   .command("setup-mcp")

package/src/commands/index.ts

@@ -18,6 +18,7 @@ export const agentCommands = [
   "omc-explore",
   "omc-plan",
   "omc-start-work",
+  "omc-status",
 ] as const;
 
 // Quick action commands (omcx- prefix)
@@ -26,10 +27,16 @@ export const actionCommands = [
   "omcx-implement",
   "omcx-refactor",
   "omcx-docs",
+  "omcx-issue",
+] as const;
+
+// Special mode commands
+export const modeCommands = [
+  "ulw", // Ultrawork mode - work until done
 ] as const;
 
 // All commands
-export const commands = [...agentCommands, ...actionCommands] as const;
+export const commands = [...agentCommands, ...actionCommands, ...modeCommands] as const;
 
 export type CommandName = typeof commands[number];
 

package/src/commands/omc-status.md

@@ -0,0 +1,71 @@
+# /omc-status
+
+Display status dashboard for oh-my-claude MCP background agents.
+
+## Instructions
+
+The user wants to see the current status of MCP background agents. Display a formatted ASCII dashboard showing:
+
+1. **Active Tasks** - Currently running background tasks
+2. **Provider Concurrency** - Usage bars for each provider
+3. **Recent Tasks** - Last 5 completed/failed tasks
+
+**Step 1: Get system status**
+
+```
+Use mcp__oh-my-claude-background__get_status to get:
+- Provider configuration (which have API keys)
+- Concurrency limits per provider
+- Current active task counts
+```
+
+**Step 2: Get task list**
+
+```
+Use mcp__oh-my-claude-background__list_tasks with:
+- limit: 20
+(Gets recent tasks including running, completed, failed, fallback_required)
+```
+
+**Step 3: Display dashboard**
+
+Format the output as an ASCII dashboard:
+
+```
+oh-my-claude Status Dashboard
+==============================
+
+ACTIVE TASKS (count)
+  [agent]     task_id...  Provider  [progress] status duration
+
+PROVIDER CONCURRENCY
+  Provider:   [bar]  active/limit active, queued queued
+
+RECENT TASKS (last 5)
+  [status] task_id agent  time_ago
+```
+
+**ASCII Progress Bar Helper:**
+
+For concurrency bars, use:
+- Full blocks: active tasks
+- Empty blocks: remaining capacity
+- 10 character width total
+
+```
+Example: 4/10 active -> "4/10 active"
+```
+
+**Status indicators:**
+- `running` - Task is executing
+- `completed` - Task finished successfully
+- `failed` - Task encountered an error
+- `fallback_required` - Provider API key not configured
+
+**If no tasks:**
+Display a message that no background tasks have been run yet, and suggest using `/omc-oracle` or other agent commands.
+
+**If MCP server not available:**
+Display an error message suggesting to run `oh-my-claude doctor` to check configuration.
+
+Now gather the status and display the dashboard.

package/src/commands/omcx-issue.md

@@ -0,0 +1,175 @@
+# /omcx-issue
+
+Report a bug to oh-my-claude GitHub Issues.
+
+## Instructions
+
+Create a bug report for the oh-my-claude project with auto-collected environment diagnostics.
+
+### Prerequisites Check
+
+**FIRST**: Verify GitHub MCP is available by calling:
+```
+mcp__plugin_github_github__get_me()
+```
+
+If this fails or the tool is not available, display:
+```
+GitHub MCP is not available. To report issues, you need the GitHub MCP plugin.
+
+Install it with:
+  claude mcp add github -- npx -y @modelcontextprotocol/server-github
+
+Or report manually at: https://github.com/lgcyaxi/oh-my-claude/issues/new
+```
+Then stop execution.
+
+### Workflow
+
+1. **Collect Environment Diagnostics**
+
+   Run these commands to gather system info:
+   ```bash
+   # oh-my-claude version
+   oh-my-claude --version 2>/dev/null || npx @lgcyaxi/oh-my-claude --version 2>/dev/null || echo "unknown"
+
+   # OS info
+   uname -s -r
+
+   # Node.js version
+   node --version
+
+   # Bun version (optional)
+   bun --version 2>/dev/null || echo "not installed"
+
+   # Installation type detection
+   which oh-my-claude >/dev/null 2>&1 && echo "global" || echo "npx"
+
+   # Doctor output (sanitized)
+   oh-my-claude doctor --no-color 2>/dev/null || npx @lgcyaxi/oh-my-claude doctor --no-color 2>/dev/null || echo "doctor command failed"
+   ```
+
+2. **Gather Issue Details from User**
+
+   Ask the user for:
+   - Brief summary of the issue (1 line - used as title)
+   - What happened (actual behavior)
+   - What was expected
+   - Steps to reproduce (optional)
+   - Any additional context
+
+3. **Generate Issue Draft**
+
+   Format the issue body:
+   ```markdown
+   ## Description
+   [User's brief summary]
+
+   ## What happened
+   [User's actual behavior description]
+
+   ## Expected behavior
+   [User's expected behavior]
+
+   ## Steps to reproduce
+   [User's steps, or "N/A" if not provided]
+
+   ## Environment
+
+   | Component | Value |
+   |-----------|-------|
+   | oh-my-claude | [version] |
+   | OS | [os info] |
+   | Node.js | [version] |
+   | Bun | [version or "not installed"] |
+   | Installation | [global/npx] |
+
+   <details>
+   <summary>Doctor output</summary>
+
+   ```
+   [doctor command output - sanitized, no API keys]
+   ```
+
+   </details>
+
+   ## Additional context
+   [User's additional context, or "None"]
+
+   ---
+   *Reported via `/omcx-issue` command*
+   ```
+
+4. **Show Draft and Request Confirmation**
+
+   Display the complete issue to the user:
+   ```
+   Issue Draft
+   -----------
+
+   Title: [Bug] [summary]
+
+   [issue body]
+
+   -----------
+
+   Does this look correct?
+   - "yes" or "submit" to create the issue
+   - "edit" to modify before submitting
+   - "cancel" to abort
+   ```
+
+5. **Submit Issue**
+
+   On confirmation, create the issue:
+   ```
+   mcp__plugin_github_github__issue_write(
+     method: "create",
+     owner: "lgcyaxi",
+     repo: "oh-my-claude",
+     title: "[Bug] <user's summary>",
+     body: "<generated body>",
+     labels: ["bug", "user-reported"]
+   )
+   ```
+
+6. **Report Result**
+
+   On success:
+   ```
+   Issue created successfully!
+
+   View at: https://github.com/lgcyaxi/oh-my-claude/issues/<number>
+
+   Thank you for helping improve oh-my-claude!
+   ```
+
+   On failure:
+   ```
+   Failed to create issue: <error message>
+
+   You can report manually at: https://github.com/lgcyaxi/oh-my-claude/issues/new
+   ```
+
+### Important Notes
+
+- Always sanitize doctor output - never include API keys
+- Use `npx @lgcyaxi/oh-my-claude` as fallback when global command unavailable
+- Labels "bug" and "user-reported" are applied automatically
+- Issue title format: `[Bug] <user's summary>`
+
+### Arguments
+
+`/omcx-issue [quick description]`
+
+- If description provided: Use as the issue summary
+- If no description: Prompt user for issue summary
+
+### Examples
+
+```
+/omcx-issue commands not installing properly
+/omcx-issue MCP server fails to connect
+/omcx-issue oracle agent returns empty response
+/omcx-issue
+```