omkx 0.1.0 → 0.1.1

package/README.md

@@ -35,33 +35,56 @@ omkx provides a three-tier agent system where main agents orchestrate work and s
 ## Quick Start
 
 ```bash
-npx omkx@latest install
+npx omkx@latest
 ```
 
-This installs all agents, prompts, hooks, skills, and configuration into your Kiro project's `.kiro/` directory.
+Or for global install (available in all projects):
+
+```bash
+npx omkx@latest --global
+```
+
+This copies all agents, prompts, hooks, skills, steering files, and MCP configuration into `.kiro/` — either `./.kiro/` (local) or `~/.kiro/` (global). Then open your project in Kiro and the agents are available — `ctrl+p` for Prometheus (planner), `ctrl+a` for Atlas (plan executor), `ctrl+e` for Sisyphus (direct tasks).
 
 ---
 
 ## Installation
 
-### Option 1: npx (Recommended)
+Two ways:
+
+**Option 1 — npx (no clone needed):**
 
 ```bash
-npx omkx@latest install
+npx omkx@latest
 ```
 
-### Option 2: Using the install script
+Or for global install (available in all projects):
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/seyisulu/omkx/main/install.sh | bash
+npx omkx@latest --global
 ```
 
-### Option 3: Local development
+**Option 2 — from the repo:**
 
 ```bash
 git clone https://github.com/seyisulu/omkx.git
 cd omkx
-bash install.sh
+./install.sh            # local install (current project only)
+./install.sh --global   # global install (all projects)
+```
+
+Both methods copy the `.kiro/` directory (agents, prompts, hooks, skills, steering files, MCP config) into either `./.kiro/` (local) or `~/.kiro/` (global). Then just open your project in Kiro and the agents are available — `ctrl+p` for Prometheus (planner), `ctrl+a` for Atlas (plan executor), `ctrl+e` for Sisyphus (direct tasks).
+
+### Updating later
+
+```bash
+npx omkx@latest --update
+```
+
+### Uninstalling
+
+```bash
+npx omkx@latest --uninstall
 ```
 
 ---
@@ -287,13 +310,16 @@ Update files in `.kiro/steering/omkx/` to change project conventions, plan forma
 ## Commands
 
 ```bash
-omkx install            # Install omkx agents and configuration
-omkx install --force    # Force reinstall
+omkx                      # Install (local, current project only)
+omkx --global             # Install globally (all projects)
+omkx --update             # Update to the latest version
+omkx --uninstall          # Remove omkx
+omkx install --force      # Force reinstall
 omkx install --dir <path> # Install to specific directory
-omkx status             # Show installation status
-omkx list               # List all installed agents
-omkx plans              # List execution plans
-omkx help               # Show help
+omkx status               # Show installation status
+omkx list                 # List all installed agents
+omkx plans                # List execution plans
+omkx help                 # Show help
 ```
 
 ---
@@ -302,7 +328,7 @@ omkx help               # Show help
 
 omkx is based on:
 
-- **[oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)** — The original TypeScript multi-agent system developed by seyisulu. Agent personalities, workflows, and delegation patterns are adapted from this project.
+- **[oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)** — The original TypeScript multi-agent system developed by code-yeongyu. Agent personalities, workflows, and delegation patterns are adapted from this project.
 - **[oh-my-kiro](https://github.com/NachoFLizaur/oh-my-kiro)** — The Kiro IDE agent format and conventions that omkx follows.
 
 ### Agent Name Origins

package/bin/cli.mjs

@@ -1,12 +1,21 @@
 #!/usr/bin/env node
 
-import { readFileSync, existsSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
+import {
+  readFileSync,
+  existsSync,
+  cpSync,
+  mkdirSync,
+  writeFileSync,
+  rmSync,
+  rmdirSync,
+} from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+import { homedir } from "os";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const PKG_ROOT = resolve(__dirname, '..');
+const PKG_ROOT = resolve(__dirname, "..");
 
 // ─── Help ────────────────────────────────────────────────────────────────
 
@@ -17,22 +26,27 @@ function showHelp() {
 ║         Multi-Agent Orchestration for Kiro               ║
 ╚══════════════════════════════════════════════════════════╝
 
-Usage: omkx <command> [options]
+Usage: omkx [command] [options]
 
 Commands:
-  install       Install omkx agents and configuration
+  (default)     Install omkx agents and configuration
   status        Show installation status
   list          List installed agents
   plans         List execution plans
   help          Show this help
 
-Installation:
-  npx omkx@latest install     Install to current directory
-  omkx install --force        Force reinstall
-  omkx install --dir <path>   Install to specific directory
+Flags:
+  --global      Install/uninstall globally (~/.kiro) instead of locally (./.kiro)
+  --update      Update to the latest version (force reinstall)
+  --uninstall   Remove omkx from the target directory
+  --force       Force reinstall
+  --dir <path>  Target directory (default: current directory)
 
 Examples:
-  omkx install                Install omkx in current directory
+  npx omkx@latest             Install in current project
+  npx omkx@latest --global    Install globally (all projects)
+  npx omkx@latest --update    Update to the latest version
+  npx omkx@latest --uninstall Remove omkx
   omkx status                 Check what's installed
   omkx list                   List all agents
   omkx plans                  List plans from .kiro/plans/
@@ -51,10 +65,12 @@ Repository: https://github.com/seyisulu/omkx
 
 function getVersion() {
   try {
-    const pkg = JSON.parse(readFileSync(resolve(PKG_ROOT, 'package.json'), 'utf8'));
+    const pkg = JSON.parse(
+      readFileSync(resolve(PKG_ROOT, "package.json"), "utf8"),
+    );
     return pkg.version;
   } catch {
-    return '0.1.0';
+    return "0.1.0";
   }
 }
 
@@ -62,153 +78,171 @@ function getVersion() {
 
 const MANIFEST = {
   agents: [
-    'prometheus.json',
-    'atlas.json',
-    'sisyphus.json',
-    'ghost-explorer.json',
-    'ghost-metis.json',
-    'ghost-momus.json',
-    'ghost-oracle.json',
-    'ghost-librarian.json',
-    'ghost-junior.json',
-    'ghost-looker.json',
+    "prometheus.json",
+    "atlas.json",
+    "sisyphus.json",
+    "ghost-explorer.json",
+    "ghost-metis.json",
+    "ghost-momus.json",
+    "ghost-oracle.json",
+    "ghost-librarian.json",
+    "ghost-junior.json",
+    "ghost-looker.json",
   ],
   prompts: [
-    'prometheus.md',
-    'atlas.md',
-    'sisyphus.md',
-    'ghost-explorer.md',
-    'ghost-metis.md',
-    'ghost-momus.md',
-    'ghost-oracle.md',
-    'ghost-librarian.md',
-    'ghost-junior.md',
-    'ghost-looker.md',
+    "prometheus.md",
+    "atlas.md",
+    "sisyphus.md",
+    "ghost-explorer.md",
+    "ghost-metis.md",
+    "ghost-momus.md",
+    "ghost-oracle.md",
+    "ghost-librarian.md",
+    "ghost-junior.md",
+    "ghost-looker.md",
   ],
   hooks: [
-    'agent-spawn.sh',
-    'pre-tool-use.sh',
-    'prometheus-read-guard.sh',
-    'prometheus-write-guard.sh',
+    "agent-spawn.sh",
+    "pre-tool-use.sh",
+    "prometheus-read-guard.sh",
+    "prometheus-write-guard.sh",
   ],
   steering: [
-    'product.md',
-    'conventions.md',
-    'plan-format.md',
-    'architecture.md',
+    "product.md",
+    "conventions.md",
+    "plan-format.md",
+    "architecture.md",
   ],
   skills: [
-    'git-operations',
-    'code-review',
-    'frontend-ux',
-    'debugging',
-    'programming',
-  ],
-  settings: [
-    'mcp.json',
+    "git-operations",
+    "code-review",
+    "frontend-ux",
+    "debugging",
+    "programming",
   ],
+  settings: ["mcp.json"],
 };
 
 function install(targetDir, force = false) {
-  const kiroDir = resolve(targetDir, '.kiro');
+  const kiroDir = resolve(targetDir, ".kiro");
+  const isGlobal = resolve(targetDir) === homedir();
+  const scope = isGlobal ? "globally" : "locally";
 
   // Check if already installed
-  const manifestMarker = resolve(kiroDir, 'agents', 'prometheus.json');
+  const manifestMarker = resolve(kiroDir, "agents", "prometheus.json");
   if (existsSync(manifestMarker) && !force) {
-    console.log('✅ omkx is already installed.');
-    console.log('   Use --force to reinstall.');
+    console.log(`✅ omkx is already installed ${scope} (${kiroDir}).`);
+    console.log("   Use --force or --update to reinstall.");
     return;
   }
 
-  console.log(`📦 Installing omkx to ${targetDir}...\n`);
+  console.log(`📦 Installing omkx ${scope} to ${kiroDir}...\n`);
 
   // Copy .kiro directory
-  copyDir(resolve(PKG_ROOT, '.kiro'), kiroDir);
+  copyDir(resolve(PKG_ROOT, ".kiro"), kiroDir);
 
   // Make hooks executable
-  const hooksDir = resolve(kiroDir, 'hooks');
+  const hooksDir = resolve(kiroDir, "hooks");
   try {
-    execSync(`chmod +x ${hooksDir}/*.sh`, { stdio: 'pipe' });
+    execSync(`chmod +x ${hooksDir}/*.sh`, { stdio: "pipe" });
   } catch {
     // Ignore if no hooks dir
   }
 
   // Create empty dirs with gitkeep
-  ensureDir(resolve(kiroDir, 'plans'));
-  ensureDir(resolve(kiroDir, 'notepads'));
-  touchIfMissing(resolve(kiroDir, 'plans', '.gitkeep'));
-  touchIfMissing(resolve(kiroDir, 'notepads', '.gitkeep'));
-
-  console.log('');
-  console.log('✅ omkx installed successfully!');
-  console.log('');
-  console.log('📂 Installed structure:');
+  ensureDir(resolve(kiroDir, "plans"));
+  ensureDir(resolve(kiroDir, "notepads"));
+  touchIfMissing(resolve(kiroDir, "plans", ".gitkeep"));
+  touchIfMissing(resolve(kiroDir, "notepads", ".gitkeep"));
+
+  console.log("");
+  console.log("✅ omkx installed successfully!");
+  console.log("");
+  console.log("📂 Installed structure:");
   console.log(`   .kiro/agents/       → ${MANIFEST.agents.length} agents`);
   console.log(`   .kiro/prompts/      → ${MANIFEST.prompts.length} prompts`);
   console.log(`   .kiro/hooks/        → ${MANIFEST.hooks.length} hooks`);
   console.log(`   .kiro/skills/       → ${MANIFEST.skills.length} skills`);
-  console.log(`   .kiro/steering/omkx/ → ${MANIFEST.steering.length} steering files`);
+  console.log(
+    `   .kiro/steering/omkx/ → ${MANIFEST.steering.length} steering files`,
+  );
   console.log(`   .kiro/settings/     → ${MANIFEST.settings.length} settings`);
   console.log(`   .kiro/plans/        → Execution plans`);
   console.log(`   .kiro/notepads/     → Agent notepads`);
-  console.log('');
-  console.log('⌨️  Keyboard Shortcuts in Kiro:');
-  console.log('   ctrl+p → Prometheus (Planner)');
-  console.log('   ctrl+a → Atlas (Plan Executor)');
-  console.log('   ctrl+e → Sisyphus (Direct Executor)');
-  console.log('');
-  console.log('📖 Read .kiro/steering/omkx/product.md for full documentation.');
+  console.log("");
+  console.log("⌨️  Keyboard Shortcuts in Kiro:");
+  console.log("   ctrl+p → Prometheus (Planner)");
+  console.log("   ctrl+a → Atlas (Plan Executor)");
+  console.log("   ctrl+e → Sisyphus (Direct Executor)");
+  console.log("");
+  console.log("📖 Read .kiro/steering/omkx/product.md for full documentation.");
 }
 
 // ─── Status ───────────────────────────────────────────────────────────────
 
 function status(targetDir) {
-  const kiroDir = resolve(targetDir, '.kiro');
-  const manifestMarker = resolve(kiroDir, 'agents', 'prometheus.json');
+  const kiroDir = resolve(targetDir, ".kiro");
+  const manifestMarker = resolve(kiroDir, "agents", "prometheus.json");
 
-  console.log('🔍 omkx Status\n');
+  console.log("🔍 omkx Status\n");
 
   if (!existsSync(manifestMarker)) {
-    console.log('❌ omkx is NOT installed.');
-    console.log('   Run: npx omkx install');
+    console.log("❌ omkx is NOT installed.");
+    console.log("   Run: npx omkx install");
     return;
   }
 
-  console.log('✅ omkx is installed.\n');
+  console.log("✅ omkx is installed.\n");
 
   // Count agents
-  const agentsDir = resolve(kiroDir, 'agents');
+  const agentsDir = resolve(kiroDir, "agents");
   let agentCount = 0;
   if (existsSync(agentsDir)) {
-    agentCount = MANIFEST.agents.filter(a => existsSync(resolve(agentsDir, a))).length;
+    agentCount = MANIFEST.agents.filter((a) =>
+      existsSync(resolve(agentsDir, a)),
+    ).length;
   }
   console.log(`   Agents: ${agentCount}/${MANIFEST.agents.length}`);
 
   // Count prompts
-  const promptsDir = resolve(kiroDir, 'prompts');
+  const promptsDir = resolve(kiroDir, "prompts");
   let promptCount = 0;
   if (existsSync(promptsDir)) {
-    promptCount = MANIFEST.prompts.filter(p => existsSync(resolve(promptsDir, p))).length;
+    promptCount = MANIFEST.prompts.filter((p) =>
+      existsSync(resolve(promptsDir, p)),
+    ).length;
   }
   console.log(`   Prompts: ${promptCount}/${MANIFEST.prompts.length}`);
 
   // Count plans
-  const plansDir = resolve(kiroDir, 'plans');
+  const plansDir = resolve(kiroDir, "plans");
   let planCount = 0;
   if (existsSync(plansDir)) {
     try {
-      planCount = execSync(`ls -1 ${plansDir}/*.md 2>/dev/null | wc -l`, { stdio: 'pipe' }).toString().trim();
-    } catch { planCount = 0; }
+      planCount = execSync(`ls -1 ${plansDir}/*.md 2>/dev/null | wc -l`, {
+        stdio: "pipe",
+      })
+        .toString()
+        .trim();
+    } catch {
+      planCount = 0;
+    }
   }
   console.log(`   Plans: ${planCount}`);
 
   // Count notepads
-  const notepadsDir = resolve(kiroDir, 'notepads');
+  const notepadsDir = resolve(kiroDir, "notepads");
   let notepadCount = 0;
   if (existsSync(notepadsDir)) {
     try {
-      notepadCount = execSync(`ls -1d ${notepadsDir}/*/ 2>/dev/null | wc -l`, { stdio: 'pipe' }).toString().trim();
-    } catch { notepadCount = 0; }
+      notepadCount = execSync(`ls -1d ${notepadsDir}/*/ 2>/dev/null | wc -l`, {
+        stdio: "pipe",
+      })
+        .toString()
+        .trim();
+    } catch {
+      notepadCount = 0;
+    }
   }
   console.log(`   Notepads: ${notepadCount}`);
 }
@@ -216,45 +250,51 @@ function status(targetDir) {
 // ─── List ──────────────────────────────────────────────────────────────────
 
 function list(targetDir) {
-  const kiroDir = resolve(targetDir, '.kiro');
-  const agentsDir = resolve(kiroDir, 'agents');
+  const kiroDir = resolve(targetDir, ".kiro");
+  const agentsDir = resolve(kiroDir, "agents");
 
-  console.log('🤖 omkx Agents\n');
+  console.log("🤖 omkx Agents\n");
 
   if (!existsSync(agentsDir)) {
-    console.log('❌ No agents found. Run: npx omkx install');
+    console.log("❌ No agents found. Run: npx omkx install");
     return;
   }
 
-  console.log('Main Agents:');
-  const mainAgents = ['prometheus', 'atlas', 'sisyphus'];
-  const shortcuts = { prometheus: 'ctrl+p', atlas: 'ctrl+a', sisyphus: 'ctrl+e' };
+  console.log("Main Agents:");
+  const mainAgents = ["prometheus", "atlas", "sisyphus"];
+  const shortcuts = {
+    prometheus: "ctrl+p",
+    atlas: "ctrl+a",
+    sisyphus: "ctrl+e",
+  };
   const descriptions = {
-    prometheus: 'Planner — creates execution plans',
-    atlas: 'Plan Executor — orchestrates plan execution',
-    sisyphus: 'Direct Executor — handles ad-hoc tasks',
+    prometheus: "Planner — creates execution plans",
+    atlas: "Plan Executor — orchestrates plan execution",
+    sisyphus: "Direct Executor — handles ad-hoc tasks",
   };
 
   for (const name of mainAgents) {
     const file = resolve(agentsDir, `${name}.json`);
-    const installed = existsSync(file) ? '✅' : '❌';
-    console.log(`  ${installed} ${name.padEnd(16)} ${shortcuts[name].padEnd(8)} ${descriptions[name]}`);
+    const installed = existsSync(file) ? "✅" : "❌";
+    console.log(
+      `  ${installed} ${name.padEnd(16)} ${shortcuts[name].padEnd(8)} ${descriptions[name]}`,
+    );
   }
 
-  console.log('\nSubagents:');
+  console.log("\nSubagents:");
   const subAgents = [
-    { name: 'ghost-oracle', desc: 'Strategic technical advisor' },
-    { name: 'ghost-metis', desc: 'Pre-planning analyst' },
-    { name: 'ghost-momus', desc: 'Plan validator' },
-    { name: 'ghost-librarian', desc: 'Research specialist' },
-    { name: 'ghost-explorer', desc: 'Codebase explorer' },
-    { name: 'ghost-junior', desc: 'Implementation specialist' },
-    { name: 'ghost-looker', desc: 'Media analyst' },
+    { name: "ghost-oracle", desc: "Strategic technical advisor" },
+    { name: "ghost-metis", desc: "Pre-planning analyst" },
+    { name: "ghost-momus", desc: "Plan validator" },
+    { name: "ghost-librarian", desc: "Research specialist" },
+    { name: "ghost-explorer", desc: "Codebase explorer" },
+    { name: "ghost-junior", desc: "Implementation specialist" },
+    { name: "ghost-looker", desc: "Media analyst" },
   ];
 
   for (const agent of subAgents) {
     const file = resolve(agentsDir, `${agent.name}.json`);
-    const installed = existsSync(file) ? '✅' : '❌';
+    const installed = existsSync(file) ? "✅" : "❌";
     console.log(`  ${installed} ${agent.name.padEnd(20)} ${agent.desc}`);
   }
 }
@@ -262,43 +302,111 @@ function list(targetDir) {
 // ─── Plans ─────────────────────────────────────────────────────────────────
 
 function plans(targetDir) {
-  const plansDir = resolve(targetDir, '.kiro', 'plans');
+  const plansDir = resolve(targetDir, ".kiro", "plans");
 
-  console.log('📐 Execution Plans\n');
+  console.log("📐 Execution Plans\n");
 
   if (!existsSync(plansDir)) {
-    console.log('No plans directory found. Create plans with Prometheus (ctrl+p).');
+    console.log(
+      "No plans directory found. Create plans with Prometheus (ctrl+p).",
+    );
     return;
   }
 
   try {
-    const output = execSync(`ls -1t ${plansDir}/*.md 2>/dev/null`, { stdio: 'pipe' }).toString().trim();
+    const output = execSync(`ls -1t ${plansDir}/*.md 2>/dev/null`, {
+      stdio: "pipe",
+    })
+      .toString()
+      .trim();
     if (!output) {
-      console.log('No plans found. Create plans with Prometheus (ctrl+p).');
+      console.log("No plans found. Create plans with Prometheus (ctrl+p).");
       return;
     }
-    const planFiles = output.split('\n');
+    const planFiles = output.split("\n");
     for (const plan of planFiles) {
-      const name = plan.split('/').pop();
+      const name = plan.split("/").pop();
       // Try to extract title from first line
       try {
-        const firstLine = execSync(`head -1 "${plan}"`, { stdio: 'pipe' }).toString().trim();
-        const title = firstLine.replace(/^#\s*(Plan:\s*)?/, '');
+        const firstLine = execSync(`head -1 "${plan}"`, { stdio: "pipe" })
+          .toString()
+          .trim();
+        const title = firstLine.replace(/^#\s*(Plan:\s*)?/, "");
         console.log(`  📄 ${name}`);
         console.log(`     ${title}`);
       } catch {
         console.log(`  📄 ${name}`);
       }
-      console.log('');
+      console.log("");
     }
   } catch {
-    console.log('No plans found.');
+    console.log("No plans found.");
   }
 }
 
-// ─── Utilities ─────────────────────────────────────────────────────────────
+// ─── Uninstall ────────────────────────────────────────────────────────────
+
+function uninstall(targetDir) {
+  const kiroDir = resolve(targetDir, ".kiro");
+  const isGlobal = resolve(targetDir) === homedir();
+  const scope = isGlobal ? "global" : "local";
+  const manifestMarker = resolve(kiroDir, "agents", "prometheus.json");
+
+  console.log("🗑️  Uninstalling omkx...\n");
+
+  if (!existsSync(manifestMarker)) {
+    console.log(`❌ omkx is not installed ${scope} (${kiroDir}).`);
+    return;
+  }
+
+  // Remove all omkx-managed directories and files
+  const targets = [
+    "agents",
+    "prompts",
+    "hooks",
+    "skills",
+    "settings/mcp.json",
+    "steering/omkx",
+  ];
+
+  const removed = [];
+  for (const t of targets) {
+    const path = resolve(kiroDir, t);
+    if (existsSync(path)) {
+      rmSync(path, { recursive: true, force: true });
+      removed.push(t);
+    }
+  }
+
+  // Clean up now-empty parent dirs (steering/, settings/)
+  for (const dir of ["steering", "settings"]) {
+    const path = resolve(kiroDir, dir);
+    try {
+      rmdirSync(path);
+      removed.push(`${dir}/`);
+    } catch {
+      // Not empty or doesn't exist — leave it alone
+    }
+  }
+
+  // Try to remove .kiro itself if entirely empty.
+  // If plans/ or notepads/ still has user content, .kiro is kept.
+  let kiroRemoved = false;
+  try {
+    rmdirSync(kiroDir);
+    kiroRemoved = true;
+  } catch {
+    // User still has plans/notepads — preserve them
+  }
+
+  console.log(`✅ omkx removed ${scope} from ${kiroDir}`);
+  console.log(`   Removed: ${removed.join(", ")}`);
+  if (!kiroRemoved) {
+    console.log(`   Kept: ${kiroDir}/plans/, ${kiroDir}/notepads/ (your data)`);
+  }
+}
 
-import { cpSync, mkdirSync, writeFileSync } from 'fs';
+// ─── Utilities ─────────────────────────────────────────────────────────────
 
 function copyDir(src, dest) {
   cpSync(src, dest, { recursive: true });
@@ -310,7 +418,7 @@ function ensureDir(dir) {
 
 function touchIfMissing(file) {
   if (!existsSync(file)) {
-    writeFileSync(file, '');
+    writeFileSync(file, "");
   }
 }
 
@@ -318,36 +426,74 @@ function touchIfMissing(file) {
 
 function main() {
   const args = process.argv.slice(2);
-  const command = args[0] || 'help';
 
   let targetDir = process.cwd();
   let force = false;
-
-  // Parse flags
-  for (let i = 1; i < args.length; i++) {
-    if (args[i] === '--dir' && args[i + 1]) {
-      targetDir = resolve(args[++i]);
-    } else if (args[i] === '--force') {
+  let global = false;
+  let doUpdate = false;
+  let doUninstall = false;
+  let command = null;
+
+  // Parse all args — flags can appear anywhere.
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--global" || arg === "-g") {
+      global = true;
+    } else if (arg === "--force" || arg === "-f") {
       force = true;
+    } else if (arg === "--update") {
+      doUpdate = true;
+    } else if (arg === "--uninstall") {
+      doUninstall = true;
+    } else if (arg === "--dir" && args[i + 1]) {
+      targetDir = resolve(args[++i]);
+    } else if (arg === "--help" || arg === "-h") {
+      showHelp();
+      return;
+    } else if (!arg.startsWith("-")) {
+      // First non-flag arg is the command (install/status/list/plans/help)
+      if (!command) command = arg;
+    } else {
+      console.log(`Unknown option: ${arg}`);
+      console.log('Run "omkx help" for usage information.');
+      process.exit(1);
     }
   }
 
+  // --global targets the user's home directory (~/.kiro)
+  if (global) {
+    targetDir = homedir();
+  }
+
+  // --uninstall removes omkx from the target directory
+  if (doUninstall) {
+    uninstall(targetDir);
+    return;
+  }
+
+  // --update reinstalls with force (useful with npx to pull latest)
+  if (doUpdate) {
+    install(targetDir, true);
+    return;
+  }
+
+  // Default command is install (so bare `npx omkx@latest` installs)
+  command = command || "install";
+
   switch (command) {
-    case 'install':
+    case "install":
       install(targetDir, force);
       break;
-    case 'status':
+    case "status":
       status(targetDir);
       break;
-    case 'list':
+    case "list":
       list(targetDir);
       break;
-    case 'plans':
+    case "plans":
       plans(targetDir);
       break;
-    case 'help':
-    case '--help':
-    case '-h':
+    case "help":
       showHelp();
       break;
     default:

package/install.sh

@@ -1,21 +1,28 @@
 #!/bin/bash
 # omkx — Install Script
 # Installs omkx multi-agent orchestration into the current Kiro project
-# Usage: bash install.sh [--force] [--dir <path>]
+# Usage: bash install.sh [--force] [--global] [--dir <path>]
 
 set -e
 
 FORCE=false
+GLOBAL=false
 TARGET_DIR="$(pwd)"
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
     --force) FORCE=true; shift ;;
+    --global) GLOBAL=true; shift ;;
     --dir) TARGET_DIR="$2"; shift 2 ;;
     *) echo "Unknown option: $1"; exit 1 ;;
   esac
 done
 
+# --global installs to ~/.kiro so agents are available in all projects
+if [ "$GLOBAL" = true ]; then
+  TARGET_DIR="$HOME"
+fi
+
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 KIRO_DIR="$TARGET_DIR/.kiro"
 

package/package.json

@@ -1,14 +1,34 @@
 {
   "name": "omkx",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Multi-agent orchestration for Kiro — agents from oh-my-openagent adapted for the Kiro IDE",
-  "bin": { "omkx": "bin/cli.mjs" },
-  "files": ["bin/", ".kiro/", "install.sh"],
+  "bin": {
+    "omkx": "bin/cli.mjs"
+  },
+  "files": [
+    "bin/",
+    ".kiro/",
+    "install.sh"
+  ],
   "type": "module",
-  "keywords": ["kiro", "kiro-cli", "kiro-agents", "ai", "agents", "multi-agent", "orchestration", "oh-my-openagent"],
+  "keywords": [
+    "kiro",
+    "kiro-cli",
+    "kiro-agents",
+    "ai",
+    "agents",
+    "multi-agent",
+    "orchestration",
+    "oh-my-openagent"
+  ],
   "author": "seyisulu",
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/seyisulu/omkx.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seyisulu/omkx.git"
+  },
   "homepage": "https://github.com/seyisulu/omkx#readme",
-  "engines": { "node": ">=18.0.0" }
+  "engines": {
+    "node": ">=18.0.0"
+  }
 }