@hanzlaa/rcode 3.4.15 → 3.4.17

package/cli/doctor.js

@@ -259,6 +259,77 @@ function runCompliance(packageRoot) {
   return failing;
 }
 
+// ---------- Duplicate-installation check ----------
+
+/**
+ * Detect rcode/rihal-code installations across all known package managers.
+ * Multiple installs cause duplicate slash commands in Claude Code (#637-#644).
+ * Returns { count, installs[], warnings[] }.
+ */
+function checkDuplicateInstalls() {
+  const os = require('os');
+  const home = os.homedir();
+  const installs = [];
+
+  // Resolve every global node_modules dir we know about.
+  const dirs = [];
+  for (const cmd of [['npm', ['root', '-g']], ['pnpm', ['root', '-g']]]) {
+    try {
+      const r = spawnSync(cmd[0], cmd[1], { encoding: 'utf8' });
+      if (r.status === 0 && r.stdout.trim()) dirs.push({ manager: cmd[0], dir: r.stdout.trim() });
+    } catch { /* not installed */ }
+  }
+  // Also scan all nvm node versions — npm root -g only covers the active one.
+  const nvmRoot = path.join(home, '.nvm', 'versions', 'node');
+  if (fs.existsSync(nvmRoot)) {
+    for (const v of fs.readdirSync(nvmRoot)) {
+      const dir = path.join(nvmRoot, v, 'lib', 'node_modules');
+      if (fs.existsSync(dir) && !dirs.some(d => d.dir === dir)) {
+        dirs.push({ manager: `nvm/${v}`, dir });
+      }
+    }
+  }
+
+  for (const { manager, dir } of dirs) {
+    for (const scope of ['@hanzlaa', '@hanzlahabib']) {
+      const scopeDir = path.join(dir, scope);
+      if (!fs.existsSync(scopeDir)) continue;
+      for (const pkg of fs.readdirSync(scopeDir)) {
+        if (pkg === 'rcode' || pkg === 'rihal-code' || pkg.startsWith('rihal')) {
+          let version = 'unknown';
+          try {
+            const pkgJson = JSON.parse(fs.readFileSync(path.join(scopeDir, pkg, 'package.json'), 'utf8'));
+            version = pkgJson.version;
+          } catch {}
+          installs.push({ manager, scope, pkg, version, dir: path.join(scopeDir, pkg) });
+        }
+      }
+    }
+  }
+
+  return { count: installs.length, installs };
+}
+
+function printDuplicateChecks(result) {
+  if (result.count === 0) {
+    console.log(`   ✓ No global rcode installs found`);
+    return 0;
+  }
+  if (result.count === 1) {
+    const i = result.installs[0];
+    console.log(`   ✓ Single global install: [${i.manager}] ${i.scope}/${i.pkg}@${i.version}`);
+    return 0;
+  }
+  // Multiple installs — DUPLICATE — this causes the duplicate-commands bug.
+  console.log(`   ✗ ${result.count} global installs detected — this causes duplicate slash commands!`);
+  for (const i of result.installs) {
+    console.log(`     [${i.manager}] ${i.scope}/${i.pkg}@${i.version}`);
+    console.log(`       ${i.dir}`);
+  }
+  console.log(`\n     Fix: rcode nuke --yes && npm install -g @hanzlaa/rcode`);
+  return 1;
+}
+
 // ---------- Entrypoint ----------
 
 module.exports = function doctor(args, { packageRoot }) {
@@ -270,10 +341,14 @@ module.exports = function doctor(args, { packageRoot }) {
   const checks = runPreflight(cwd, packageRoot);
   const preflightFailures = printChecks(checks);
 
+  console.log(`\nDuplicate installations:`);
+  const dupResult = checkDuplicateInstalls();
+  const duplicateFailures = printDuplicateChecks(dupResult);
+
   console.log(`\nPackage compliance:`);
   const complianceFailures = runCompliance(packageRoot);
 
-  const totalFailures = preflightFailures + complianceFailures;
+  const totalFailures = preflightFailures + complianceFailures + duplicateFailures;
   console.log();
   if (totalFailures === 0) {
     console.log(`✅ All checks passed.`);

package/cli/index.js

@@ -25,6 +25,7 @@ const COMMANDS = {
   update: require('./update'),
   uninstall: require('./uninstall'),
   remove: require('./uninstall'),  // alias
+  nuke: require('./nuke'),         // full cleanup across all package managers + global state
   dashboard: require('./dashboard'),
   serve: require('./dashboard'),
   digest: require('./digest'),
@@ -57,6 +58,10 @@ Usage:
   update         Refresh skill files (backs up .rihal/ state first)
   uninstall      Remove Rihal Code from the current project
   remove         Alias for uninstall
+  nuke           Wipe ALL rihal/rcode installs everywhere (global packages,
+                 binaries, ~/.claude/* rihal artifacts, ~/.rihal/, project artifacts)
+                 Default = dry-run. Pass --yes to remove. Pass --include-planning
+                 to also remove .planning/ in CWD.
   config         Get/set project configuration (project_name, user_name, etc.)
   context        Memory bank freshness (--check | --refresh | --install-hook)
   github-sync    Sync .rihal/ phases/epics/stories to GitHub (dry-run default)

package/cli/install.js

@@ -945,6 +945,26 @@ function buildInstallPlan(ide = 'claude', target = process.cwd()) {
         }
       }
     }
+    // When both claude and vscode are in the IDE list, vscode writes commands to
+    // .claude/commands/rihal/{name}.md (subdirectory) while claude writes them to
+    // .claude/commands/rihal-{name}.md (root). Claude Code reads the full tree
+    // recursively, so both sets appear as slash commands — duplicates in the UI.
+    // Drop the vscode-style subdir entries when claude entries already cover them.
+    if (ide.includes('claude') && ide.includes('vscode')) {
+      const claudeCommandRels = new Set(
+        merged
+          .filter(e => e.ide === 'claude' && e.rel.split(path.sep).join('/').startsWith('.claude/commands/'))
+          .map(e => path.basename(e.rel, '.md').replace(/^rihal-/, ''))
+      );
+      return merged.filter(e => {
+        const rel = e.rel.split(path.sep).join('/');
+        if (e.ide === 'vscode' && rel.startsWith('.claude/commands/rihal/')) {
+          const baseName = path.basename(e.rel, path.extname(e.rel));
+          return !claudeCommandRels.has(baseName);
+        }
+        return true;
+      });
+    }
     return merged;
   }
 
@@ -1731,12 +1751,18 @@ async function install(opts) {
   const globalClaudeCommands = path.join(os.homedir(), '.claude', 'commands');
   const projectClaudeCommands = path.join(opts.target, '.claude', 'commands');
   const isProjectInstall = opts.target !== os.homedir();
-  if (isProjectInstall && !opts.force && !opts.forceOverwrite) {
+  // Run dedup even when force:true — only forceOverwrite skips it.
+  if (isProjectInstall && !opts.forceOverwrite) {
     try {
-      const globalHasRihal = fs.existsSync(globalClaudeCommands) &&
-        fs.readdirSync(globalClaudeCommands).some(f => f.startsWith('rihal-') && f.endsWith('.md'));
-      const projectHasRihal = fs.existsSync(projectClaudeCommands) &&
-        fs.readdirSync(projectClaudeCommands).some(f => f.startsWith('rihal-') && f.endsWith('.md'));
+      // Check both root-level rihal-*.md AND the rihal/ subdirectory (vscode-style).
+      const globalHasRihal = fs.existsSync(globalClaudeCommands) && (
+        fs.readdirSync(globalClaudeCommands).some(f => f.startsWith('rihal-') && f.endsWith('.md')) ||
+        fs.existsSync(path.join(globalClaudeCommands, 'rihal'))
+      );
+      const projectHasRihal = fs.existsSync(projectClaudeCommands) && (
+        fs.readdirSync(projectClaudeCommands).some(f => f.startsWith('rihal-') && f.endsWith('.md')) ||
+        fs.existsSync(path.join(projectClaudeCommands, 'rihal'))
+      );
       if (globalHasRihal && !projectHasRihal) {
         // Global commands exist, project has none yet — filter them out of the plan
         // so we don't create duplicates. Project gets .rihal/ state only.
@@ -1754,11 +1780,17 @@ async function install(opts) {
       } else if (globalHasRihal && projectHasRihal) {
         // Both exist — project commands are duplicates. Remove project-level ones.
         try {
+          // Remove root-level rihal-*.md files
           const projectCommandFiles = fs.readdirSync(projectClaudeCommands)
             .filter(f => f.startsWith('rihal-') && f.endsWith('.md'));
           for (const f of projectCommandFiles) {
             fs.unlinkSync(path.join(projectClaudeCommands, f));
           }
+          // Remove rihal/ subdirectory (vscode-style commands)
+          const rihalSubdir = path.join(projectClaudeCommands, 'rihal');
+          if (fs.existsSync(rihalSubdir)) {
+            fs.rmSync(rihalSubdir, { recursive: true, force: true });
+          }
           const projectAgentsDir = path.join(opts.target, '.claude', 'agents');
           if (fs.existsSync(projectAgentsDir)) {
             const agentFiles = fs.readdirSync(projectAgentsDir)

package/cli/nuke.js

@@ -0,0 +1,404 @@
+/**
+ * rcode nuke — one-shot full cleanup
+ *
+ * Removes EVERY trace of rihal/rcode from the system:
+ *   - Global npm/pnpm/yarn/bun installs (both @hanzlaa/rcode and legacy @hanzlahabib/rihal-code)
+ *   - Global binaries (rcode, rihal, rihal-code) in all known PATH dirs
+ *   - Global Claude Code artifacts (~/.claude/commands/rihal*, ~/.claude/agents/rihal-*, ~/.claude/skills/rihal-*)
+ *   - Global state (~/.rihal/)
+ *   - Project-level artifacts in CWD (.claude/commands/rihal*, .claude/agents/rihal-*, .rihal/, .planning/ optional)
+ *
+ * Default mode: dry-run — prints what *would* be removed.
+ * Pass --yes to actually remove. Pass --include-planning to also remove .planning/ in CWD.
+ *
+ * Why this exists: gaps #1-#4 in the duplicate-commands incident (May 2026).
+ * - Multiple package managers can hold separate copies invisibly to each other.
+ * - rcode uninstall only cleans the project, not global package installs.
+ * - Users had no single command to fully reset.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+function exists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}
+
+function readDirSafe(p) {
+  try { return fs.readdirSync(p); } catch { return []; }
+}
+
+/**
+ * Resolve where each package manager keeps its global node_modules.
+ * Returns a list of { manager, dir } — dir may not exist.
+ */
+function getGlobalNodeModulesDirs() {
+  const home = os.homedir();
+  const candidates = [];
+
+  // npm — npm root -g resolves to the active node version's lib/node_modules.
+  try {
+    const r = spawnSync('npm', ['root', '-g'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) candidates.push({ manager: 'npm', dir: r.stdout.trim() });
+  } catch { /* npm not installed */ }
+
+  // pnpm — `pnpm root -g`
+  try {
+    const r = spawnSync('pnpm', ['root', '-g'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) candidates.push({ manager: 'pnpm', dir: r.stdout.trim() });
+  } catch { /* pnpm not installed */ }
+
+  // yarn classic — `yarn global dir` returns the parent; node_modules is inside.
+  try {
+    const r = spawnSync('yarn', ['global', 'dir'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) {
+      candidates.push({ manager: 'yarn', dir: path.join(r.stdout.trim(), 'node_modules') });
+    }
+  } catch { /* yarn not installed */ }
+
+  // bun — `bun pm bin -g` returns the bin dir; sibling install/global has node_modules.
+  try {
+    const r = spawnSync('bun', ['pm', 'bin', '-g'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) {
+      // bun layout: ~/.bun/install/global/node_modules + ~/.bun/bin
+      candidates.push({ manager: 'bun', dir: path.join(home, '.bun', 'install', 'global', 'node_modules') });
+    }
+  } catch { /* bun not installed */ }
+
+  // Hardcoded fallbacks for stale/dead version managers (nvm versions that npm root doesn't know about).
+  const nvmRoot = path.join(home, '.nvm', 'versions', 'node');
+  if (exists(nvmRoot)) {
+    for (const v of readDirSafe(nvmRoot)) {
+      const dir = path.join(nvmRoot, v, 'lib', 'node_modules');
+      if (exists(dir) && !candidates.some(c => c.dir === dir)) {
+        candidates.push({ manager: `nvm/${v}`, dir });
+      }
+    }
+  }
+
+  return candidates;
+}
+
+/**
+ * For a given global node_modules dir, return a list of rihal/rcode package paths.
+ * Looks for both @hanzlaa/rcode (current) and @hanzlahabib/rihal-code (legacy).
+ */
+function findRihalPackages(globalNodeModules) {
+  const found = [];
+  for (const scope of ['@hanzlaa', '@hanzlahabib']) {
+    const scopeDir = path.join(globalNodeModules, scope);
+    if (!exists(scopeDir)) continue;
+    for (const pkg of readDirSafe(scopeDir)) {
+      // Match rcode, rihal-code, or anything starting with rihal
+      if (pkg === 'rcode' || pkg === 'rihal-code' || pkg.startsWith('rihal')) {
+        found.push({ scope, pkg, dir: path.join(scopeDir, pkg) });
+      }
+    }
+  }
+  return found;
+}
+
+/**
+ * Resolve global bin directories where rcode/rihal/rihal-code may live.
+ */
+function getGlobalBinDirs() {
+  const home = os.homedir();
+  const dirs = new Set();
+
+  // npm prefix bin
+  try {
+    const r = spawnSync('npm', ['prefix', '-g'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) dirs.add(path.join(r.stdout.trim(), 'bin'));
+  } catch {}
+
+  // pnpm bin
+  try {
+    const r = spawnSync('pnpm', ['bin', '-g'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) dirs.add(r.stdout.trim());
+  } catch {}
+
+  // yarn bin
+  try {
+    const r = spawnSync('yarn', ['global', 'bin'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) dirs.add(r.stdout.trim());
+  } catch {}
+
+  // bun
+  try {
+    const r = spawnSync('bun', ['pm', 'bin', '-g'], { encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) dirs.add(r.stdout.trim());
+  } catch {}
+
+  // Hardcoded fallbacks
+  dirs.add(path.join(home, '.local', 'share', 'pnpm'));
+  dirs.add(path.join(home, '.local', 'bin'));
+  dirs.add(path.join(home, '.bun', 'bin'));
+
+  // nvm bins
+  const nvmRoot = path.join(home, '.nvm', 'versions', 'node');
+  if (exists(nvmRoot)) {
+    for (const v of readDirSafe(nvmRoot)) {
+      dirs.add(path.join(nvmRoot, v, 'bin'));
+    }
+  }
+
+  return [...dirs].filter(exists);
+}
+
+const RCODE_BINS = ['rcode', 'rihal', 'rihal-code'];
+
+function findRihalBins(binDir) {
+  const found = [];
+  for (const name of RCODE_BINS) {
+    const p = path.join(binDir, name);
+    if (exists(p)) {
+      let target = null;
+      try { target = fs.readlinkSync(p); } catch {}
+      // Only flag if it's clearly ours (target points at rcode/rihal-code package).
+      // If it's not a symlink, include it anyway — bare scripts in pnpm bin etc.
+      if (!target || /rcode|rihal-code|@hanzlaa|@hanzlahabib/.test(target)) {
+        found.push({ name, path: p, target });
+      }
+    }
+  }
+  return found;
+}
+
+/**
+ * Find rihal-related artifacts in a Claude Code config dir (~/.claude or .claude in CWD).
+ */
+function findClaudeArtifacts(claudeDir) {
+  const found = [];
+  if (!exists(claudeDir)) return found;
+
+  // .claude/commands/rihal-*.md (claude-style root)
+  const cmdRoot = path.join(claudeDir, 'commands');
+  if (exists(cmdRoot)) {
+    for (const f of readDirSafe(cmdRoot)) {
+      if (f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
+        found.push({ kind: 'command', path: path.join(cmdRoot, f) });
+      }
+    }
+    // .claude/commands/rihal/ (vscode-style subdir)
+    const rihalSubdir = path.join(cmdRoot, 'rihal');
+    if (exists(rihalSubdir)) {
+      found.push({ kind: 'commands-dir', path: rihalSubdir });
+    }
+  }
+
+  // .claude/agents/rihal-*.md
+  const agentsDir = path.join(claudeDir, 'agents');
+  if (exists(agentsDir)) {
+    for (const f of readDirSafe(agentsDir)) {
+      if (f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
+        found.push({ kind: 'agent', path: path.join(agentsDir, f) });
+      }
+    }
+  }
+
+  // .claude/skills/rihal-*
+  const skillsDir = path.join(claudeDir, 'skills');
+  if (exists(skillsDir)) {
+    for (const d of readDirSafe(skillsDir)) {
+      if (d.startsWith('rihal-')) {
+        found.push({ kind: 'skill-dir', path: path.join(skillsDir, d) });
+      }
+    }
+  }
+
+  return found;
+}
+
+function buildPlan({ includePlanning }) {
+  const home = os.homedir();
+  const cwd = process.cwd();
+  const plan = {
+    packages: [],
+    bins: [],
+    globalClaude: [],
+    globalRihal: null,
+    projectClaude: [],
+    projectRihal: null,
+    projectPlanning: null,
+  };
+
+  // Global node_modules packages
+  for (const { manager, dir } of getGlobalNodeModulesDirs()) {
+    for (const pkg of findRihalPackages(dir)) {
+      plan.packages.push({ manager, ...pkg });
+    }
+  }
+
+  // Global binaries
+  for (const binDir of getGlobalBinDirs()) {
+    for (const bin of findRihalBins(binDir)) {
+      plan.bins.push({ binDir, ...bin });
+    }
+  }
+
+  // Global Claude artifacts (~/.claude/)
+  plan.globalClaude = findClaudeArtifacts(path.join(home, '.claude'));
+
+  // Global state (~/.rihal/)
+  const globalRihal = path.join(home, '.rihal');
+  if (exists(globalRihal)) plan.globalRihal = globalRihal;
+
+  // Project-level (CWD only — never recurse, user may have many projects)
+  plan.projectClaude = findClaudeArtifacts(path.join(cwd, '.claude'));
+  const projectRihal = path.join(cwd, '.rihal');
+  if (exists(projectRihal) && cwd !== home) plan.projectRihal = projectRihal;
+
+  if (includePlanning) {
+    const projectPlanning = path.join(cwd, '.planning');
+    if (exists(projectPlanning) && cwd !== home) plan.projectPlanning = projectPlanning;
+  }
+
+  return plan;
+}
+
+function printPlan(plan, { dryRun }) {
+  const banner = dryRun ? '[DRY RUN — pass --yes to remove]' : '[REMOVING]';
+  console.log(`\n🔥 rcode nuke ${banner}\n`);
+
+  let total = 0;
+  const section = (title, items) => {
+    if (!items || (Array.isArray(items) && items.length === 0)) return;
+    console.log(`${title}`);
+    if (Array.isArray(items)) {
+      for (const item of items) {
+        console.log(`  • ${item.description || item.path || item.dir || JSON.stringify(item)}`);
+        total++;
+      }
+    } else {
+      console.log(`  • ${items}`);
+      total++;
+    }
+    console.log('');
+  };
+
+  section('📦 Global packages (node_modules):', plan.packages.map(p => ({
+    description: `[${p.manager}] ${p.scope}/${p.pkg}  →  ${p.dir}`,
+  })));
+
+  section('🔗 Global binaries:', plan.bins.map(b => ({
+    description: `${b.path}${b.target ? `  →  ${b.target}` : ''}`,
+  })));
+
+  section('🤖 ~/.claude/ artifacts:', plan.globalClaude.map(a => ({
+    description: `[${a.kind}] ${a.path}`,
+  })));
+
+  if (plan.globalRihal) section('🗂️  ~/.rihal/ (global state):', plan.globalRihal);
+
+  section('🤖 ./.claude/ artifacts (current project):', plan.projectClaude.map(a => ({
+    description: `[${a.kind}] ${a.path}`,
+  })));
+
+  if (plan.projectRihal) section('🗂️  ./.rihal/ (project state):', plan.projectRihal);
+  if (plan.projectPlanning) section('📋 ./.planning/ (your work — only with --include-planning):', plan.projectPlanning);
+
+  if (total === 0) {
+    console.log('  ✓ nothing to remove — system is clean.\n');
+  } else {
+    console.log(`  Total: ${total} item(s).\n`);
+  }
+  return total;
+}
+
+function rmrf(p) {
+  try { fs.rmSync(p, { recursive: true, force: true }); return true; }
+  catch (err) { console.warn(`  ⚠ failed to remove ${p}: ${err.message}`); return false; }
+}
+
+function uninstallPackage(manager, scope, pkg) {
+  const fullName = `${scope}/${pkg}`;
+  const cmd = manager === 'pnpm' ? ['pnpm', ['remove', '-g', fullName]]
+    : manager === 'yarn' ? ['yarn', ['global', 'remove', fullName]]
+    : manager === 'bun' ? ['bun', ['remove', '-g', fullName]]
+    : ['npm', ['uninstall', '-g', fullName]];
+  try {
+    const r = spawnSync(cmd[0], cmd[1], { stdio: 'pipe', encoding: 'utf8' });
+    return r.status === 0;
+  } catch { return false; }
+}
+
+function executePlan(plan) {
+  let removed = 0;
+
+  // Try clean uninstall via package manager first (cleans bins automatically)
+  for (const p of plan.packages) {
+    const manager = p.manager.startsWith('nvm/') ? 'npm' : p.manager;
+    process.stdout.write(`  ${manager} uninstall ${p.scope}/${p.pkg} ... `);
+    const ok = uninstallPackage(manager, p.scope, p.pkg);
+    console.log(ok ? '✓' : '⚠ failed via PM, falling back to rm');
+    if (!ok) rmrf(p.dir);
+    removed++;
+  }
+
+  // Force-remove any leftover bins (broken symlinks etc.)
+  for (const b of plan.bins) {
+    if (exists(b.path)) {
+      if (rmrf(b.path)) { console.log(`  ✓ removed bin ${b.path}`); removed++; }
+    }
+  }
+
+  // Claude artifacts (global)
+  for (const a of plan.globalClaude) {
+    if (rmrf(a.path)) { console.log(`  ✓ removed ${a.path}`); removed++; }
+  }
+  if (plan.globalRihal && rmrf(plan.globalRihal)) {
+    console.log(`  ✓ removed ${plan.globalRihal}`); removed++;
+  }
+
+  // Claude artifacts (project)
+  for (const a of plan.projectClaude) {
+    if (rmrf(a.path)) { console.log(`  ✓ removed ${a.path}`); removed++; }
+  }
+  if (plan.projectRihal && rmrf(plan.projectRihal)) {
+    console.log(`  ✓ removed ${plan.projectRihal}`); removed++;
+  }
+  if (plan.projectPlanning && rmrf(plan.projectPlanning)) {
+    console.log(`  ✓ removed ${plan.projectPlanning}`); removed++;
+  }
+
+  return removed;
+}
+
+module.exports = function nuke(args = []) {
+  const dryRun = !args.includes('--yes') && !args.includes('-y');
+  const includePlanning = args.includes('--include-planning');
+
+  // Safety: detect if CWD is the rcode source repo itself.
+  const cwdPkgJson = path.join(process.cwd(), 'package.json');
+  if (exists(cwdPkgJson)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(cwdPkgJson, 'utf8'));
+      if (pkg.name === '@hanzlaa/rcode' || pkg.name === '@hanzlahabib/rihal-code') {
+        console.log('\n⚠  You are inside the rcode source repo.');
+        console.log('   Nuke would remove this repo\'s .claude/, .rihal/, and possibly .planning/.');
+        console.log('   That is your source code — almost certainly not what you want.');
+        console.log('   Run nuke from a different directory, or pass --i-know-what-im-doing to override.\n');
+        if (!args.includes('--i-know-what-im-doing')) return;
+      }
+    } catch { /* package.json unreadable, ignore */ }
+  }
+
+  const plan = buildPlan({ includePlanning });
+  const total = printPlan(plan, { dryRun });
+
+  if (total === 0 || dryRun) {
+    if (dryRun && total > 0) {
+      console.log('To actually remove these, re-run with:  rcode nuke --yes');
+      console.log('To also remove .planning/ (your work):  rcode nuke --yes --include-planning\n');
+    }
+    return;
+  }
+
+  console.log('Executing...\n');
+  const removed = executePlan(plan);
+  console.log(`\n✅ Done. Removed ${removed} item(s). Reinstall:  npm install -g @hanzlaa/rcode\n`);
+};

package/cli/uninstall.js

@@ -138,9 +138,17 @@ function buildPlan(cwd, editors) {
         .readdirSync(skillsDir)
         .filter((name) => name.startsWith('rihal-') || isKnownSkillName(name));
     }
-    const commandsDir = path.join(cwd, '.claude/commands/rihal');
-    if (fs.existsSync(commandsDir)) {
-      plan.claude.commands = fs.readdirSync(commandsDir);
+    // Collect commands from vscode-style subdir (.claude/commands/rihal/) and
+    // claude-style root-level files (.claude/commands/rihal-*.md).
+    const commandsSubdir = path.join(cwd, '.claude/commands/rihal');
+    if (fs.existsSync(commandsSubdir)) {
+      plan.claude.commands = fs.readdirSync(commandsSubdir);
+    }
+    const commandsRoot = path.join(cwd, '.claude/commands');
+    if (fs.existsSync(commandsRoot)) {
+      const rootFiles = fs.readdirSync(commandsRoot)
+        .filter(f => f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc')));
+      plan.claude.commands = [...plan.claude.commands, ...rootFiles];
     }
     // v2 installs agents to .claude/agents/rihal-*.md — scan for them
     const agentsDir = path.join(cwd, '.claude/agents');
@@ -499,11 +507,26 @@ async function runUninstall(args) {
     removed += n;
     if (n > 0) console.log(`   ✓ removed ${n} Claude skills`);
 
+    // Remove vscode-style subdir .claude/commands/rihal/
     const commandsDir = path.join(cwd, '.claude/commands/rihal');
     if (fs.existsSync(commandsDir)) {
       fs.rmSync(commandsDir, { recursive: true, force: true });
-      removed += plan.claude.commands.length;
-      console.log(`   ✓ removed .claude/commands/rihal/ (${plan.claude.commands.length} slash commands)`);
+    }
+    // Remove claude-style root-level rihal-*.md files
+    const commandsRoot = path.join(cwd, '.claude/commands');
+    let commandsRemoved = 0;
+    if (fs.existsSync(commandsRoot)) {
+      for (const f of fs.readdirSync(commandsRoot)) {
+        if (f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
+          fs.unlinkSync(path.join(commandsRoot, f));
+          commandsRemoved++;
+        }
+      }
+    }
+    const totalCommandsRemoved = plan.claude.commands.length;
+    removed += totalCommandsRemoved;
+    if (totalCommandsRemoved > 0) {
+      console.log(`   ✓ removed ${totalCommandsRemoved} slash commands from .claude/commands/`);
     }
 
     // v2: .claude/agents/rihal-*.md

package/cli/update.js

@@ -142,9 +142,19 @@ function removeOldSkillFiles(cwd, editors) {
         }
       }
     }
-    const commandsDir = path.join(cwd, '.claude/commands/rihal');
-    if (fs.existsSync(commandsDir)) {
-      fs.rmSync(commandsDir, { recursive: true, force: true });
+    // Remove vscode-style subdir .claude/commands/rihal/
+    const commandsSubdir = path.join(cwd, '.claude/commands/rihal');
+    if (fs.existsSync(commandsSubdir)) {
+      fs.rmSync(commandsSubdir, { recursive: true, force: true });
+    }
+    // Remove claude-style root-level .claude/commands/rihal-*.md files
+    const commandsRoot = path.join(cwd, '.claude/commands');
+    if (fs.existsSync(commandsRoot)) {
+      for (const f of fs.readdirSync(commandsRoot)) {
+        if (f.startsWith('rihal-') && (f.endsWith('.md') || f.endsWith('.mdc'))) {
+          fs.unlinkSync(path.join(commandsRoot, f));
+        }
+      }
     }
   }
 
@@ -322,10 +332,15 @@ async function runUpdate(args, { packageRoot, packageJson }) {
   // ------ Re-run unified installer ------
   // Delegates to cli/install.js which handles all IDE-specific file shipping
   // (agents, commands, skills, workflows, references, bin). install.js is
-  // the single source of truth — update.js reuses it with --force.
+  // the single source of truth — call once with the full IDE array so that
+  // buildInstallPlan can deduplicate across IDEs (e.g. claude+vscode).
   console.log();
-  for (const ide of editors) {
-    if (!['claude', 'cursor', 'gemini'].includes(ide)) continue;
+  const supportedIdes = editors.filter(ide => ['claude', 'cursor', 'gemini'].includes(ide));
+  if (supportedIdes.length > 0) {
+    if (editors.some(ide => !['claude', 'cursor', 'gemini'].includes(ide))) {
+      const unsupported = editors.filter(ide => !['claude', 'cursor', 'gemini'].includes(ide));
+      console.log(`   ⚠ ${unsupported.join(', ')} refresh not yet supported by installer — skipping`);
+    }
     install.install({
       target: cwd,
       force: true,
@@ -334,11 +349,11 @@ async function runUpdate(args, { packageRoot, packageJson }) {
       projectName: config.project_name || require('path').basename(cwd),
       language: config.language || 'English',
       mode: config.mode || 'guided',
-      ide,
+      ides: supportedIdes,
       modules: [],
       help: false,
     });
-    console.log(`   ✓ ${ide} → refreshed via install.js`);
+    console.log(`   ✓ [${supportedIdes.join(', ')}] → refreshed via install.js`);
   }
 
   // ------ Update installed_version in config.json (atomic) ------

package/dist/rcode.js

@@ -15650,6 +15650,19 @@ ${BLOCK}`);
             }
           }
         }
+        if (ide.includes("claude") && ide.includes("vscode")) {
+          const claudeCommandRels = new Set(
+            merged.filter((e) => e.ide === "claude" && e.rel.split(path2.sep).join("/").startsWith(".claude/commands/")).map((e) => path2.basename(e.rel, ".md").replace(/^rihal-/, ""))
+          );
+          return merged.filter((e) => {
+            const rel = e.rel.split(path2.sep).join("/");
+            if (e.ide === "vscode" && rel.startsWith(".claude/commands/rihal/")) {
+              const baseName = path2.basename(e.rel, path2.extname(e.rel));
+              return !claudeCommandRels.has(baseName);
+            }
+            return true;
+          });
+        }
         return merged;
       }
       const plan = [];
@@ -16272,10 +16285,10 @@ ${BLOCK}`);
       const globalClaudeCommands = path2.join(os.homedir(), ".claude", "commands");
       const projectClaudeCommands = path2.join(opts.target, ".claude", "commands");
       const isProjectInstall = opts.target !== os.homedir();
-      if (isProjectInstall && !opts.force && !opts.forceOverwrite) {
+      if (isProjectInstall && !opts.forceOverwrite) {
         try {
-          const globalHasRihal = fs2.existsSync(globalClaudeCommands) && fs2.readdirSync(globalClaudeCommands).some((f) => f.startsWith("rihal-") && f.endsWith(".md"));
-          const projectHasRihal = fs2.existsSync(projectClaudeCommands) && fs2.readdirSync(projectClaudeCommands).some((f) => f.startsWith("rihal-") && f.endsWith(".md"));
+          const globalHasRihal = fs2.existsSync(globalClaudeCommands) && (fs2.readdirSync(globalClaudeCommands).some((f) => f.startsWith("rihal-") && f.endsWith(".md")) || fs2.existsSync(path2.join(globalClaudeCommands, "rihal")));
+          const projectHasRihal = fs2.existsSync(projectClaudeCommands) && (fs2.readdirSync(projectClaudeCommands).some((f) => f.startsWith("rihal-") && f.endsWith(".md")) || fs2.existsSync(path2.join(projectClaudeCommands, "rihal")));
           if (globalHasRihal && !projectHasRihal) {
             const before = plan.length;
             const filtered = plan.filter((e) => {
@@ -16294,6 +16307,10 @@ ${BLOCK}`);
               for (const f of projectCommandFiles) {
                 fs2.unlinkSync(path2.join(projectClaudeCommands, f));
               }
+              const rihalSubdir = path2.join(projectClaudeCommands, "rihal");
+              if (fs2.existsSync(rihalSubdir)) {
+                fs2.rmSync(rihalSubdir, { recursive: true, force: true });
+              }
               const projectAgentsDir = path2.join(opts.target, ".claude", "agents");
               if (fs2.existsSync(projectAgentsDir)) {
                 const agentFiles = fs2.readdirSync(projectAgentsDir).filter((f) => f.startsWith("rihal-") && f.endsWith(".md"));
@@ -17222,9 +17239,17 @@ var require_update = __commonJS({
             }
           }
         }
-        const commandsDir = path2.join(cwd, ".claude/commands/rihal");
-        if (fs2.existsSync(commandsDir)) {
-          fs2.rmSync(commandsDir, { recursive: true, force: true });
+        const commandsSubdir = path2.join(cwd, ".claude/commands/rihal");
+        if (fs2.existsSync(commandsSubdir)) {
+          fs2.rmSync(commandsSubdir, { recursive: true, force: true });
+        }
+        const commandsRoot = path2.join(cwd, ".claude/commands");
+        if (fs2.existsSync(commandsRoot)) {
+          for (const f of fs2.readdirSync(commandsRoot)) {
+            if (f.startsWith("rihal-") && (f.endsWith(".md") || f.endsWith(".mdc"))) {
+              fs2.unlinkSync(path2.join(commandsRoot, f));
+            }
+          }
         }
       }
       if (editors.includes("cursor")) {
@@ -17380,8 +17405,12 @@ var require_update = __commonJS({
       console.log(`   \u{1F9F9} cleaned ${totalRemoved} old skill files`);
       stripAgentsMdSection(cwd);
       console.log();
-      for (const ide of editors) {
-        if (!["claude", "cursor", "gemini"].includes(ide)) continue;
+      const supportedIdes = editors.filter((ide) => ["claude", "cursor", "gemini"].includes(ide));
+      if (supportedIdes.length > 0) {
+        if (editors.some((ide) => !["claude", "cursor", "gemini"].includes(ide))) {
+          const unsupported = editors.filter((ide) => !["claude", "cursor", "gemini"].includes(ide));
+          console.log(`   \u26A0 ${unsupported.join(", ")} refresh not yet supported by installer \u2014 skipping`);
+        }
         install.install({
           target: cwd,
           force: true,
@@ -17390,11 +17419,11 @@ var require_update = __commonJS({
           projectName: config.project_name || require("path").basename(cwd),
           language: config.language || "English",
           mode: config.mode || "guided",
-          ide,
+          ides: supportedIdes,
           modules: [],
           help: false
         });
-        console.log(`   \u2713 ${ide} \u2192 refreshed via install.js`);
+        console.log(`   \u2713 [${supportedIdes.join(", ")}] \u2192 refreshed via install.js`);
       }
       config.installed_version = packageVersion;
       writeJsonAtomic(configPath, config);
@@ -17507,9 +17536,14 @@ var require_uninstall = __commonJS({
         if (fs2.existsSync(skillsDir)) {
           plan.claude.skills = fs2.readdirSync(skillsDir).filter((name) => name.startsWith("rihal-") || isKnownSkillName(name));
         }
-        const commandsDir = path2.join(cwd, ".claude/commands/rihal");
-        if (fs2.existsSync(commandsDir)) {
-          plan.claude.commands = fs2.readdirSync(commandsDir);
+        const commandsSubdir = path2.join(cwd, ".claude/commands/rihal");
+        if (fs2.existsSync(commandsSubdir)) {
+          plan.claude.commands = fs2.readdirSync(commandsSubdir);
+        }
+        const commandsRoot = path2.join(cwd, ".claude/commands");
+        if (fs2.existsSync(commandsRoot)) {
+          const rootFiles = fs2.readdirSync(commandsRoot).filter((f) => f.startsWith("rihal-") && (f.endsWith(".md") || f.endsWith(".mdc")));
+          plan.claude.commands = [...plan.claude.commands, ...rootFiles];
         }
         const agentsDir = path2.join(cwd, ".claude/agents");
         if (fs2.existsSync(agentsDir)) {
@@ -17782,8 +17816,21 @@ var require_uninstall = __commonJS({
         const commandsDir = path2.join(cwd, ".claude/commands/rihal");
         if (fs2.existsSync(commandsDir)) {
           fs2.rmSync(commandsDir, { recursive: true, force: true });
-          removed += plan.claude.commands.length;
-          console.log(`   \u2713 removed .claude/commands/rihal/ (${plan.claude.commands.length} slash commands)`);
+        }
+        const commandsRoot = path2.join(cwd, ".claude/commands");
+        let commandsRemoved = 0;
+        if (fs2.existsSync(commandsRoot)) {
+          for (const f of fs2.readdirSync(commandsRoot)) {
+            if (f.startsWith("rihal-") && (f.endsWith(".md") || f.endsWith(".mdc"))) {
+              fs2.unlinkSync(path2.join(commandsRoot, f));
+              commandsRemoved++;
+            }
+          }
+        }
+        const totalCommandsRemoved = plan.claude.commands.length;
+        removed += totalCommandsRemoved;
+        if (totalCommandsRemoved > 0) {
+          console.log(`   \u2713 removed ${totalCommandsRemoved} slash commands from .claude/commands/`);
         }
         const agentsDir = path2.join(cwd, ".claude/agents");
         const nAgents = removeMatching(
@@ -17929,6 +17976,340 @@ To reinstall later:`);
   }
 });
 
+// cli/nuke.js
+var require_nuke = __commonJS({
+  "cli/nuke.js"(exports2, module2) {
+    "use strict";
+    var fs2 = require("fs");
+    var os = require("os");
+    var path2 = require("path");
+    var { spawnSync } = require("child_process");
+    function exists(p) {
+      try {
+        fs2.accessSync(p);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    function readDirSafe(p) {
+      try {
+        return fs2.readdirSync(p);
+      } catch {
+        return [];
+      }
+    }
+    function getGlobalNodeModulesDirs() {
+      const home = os.homedir();
+      const candidates = [];
+      try {
+        const r = spawnSync("npm", ["root", "-g"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) candidates.push({ manager: "npm", dir: r.stdout.trim() });
+      } catch {
+      }
+      try {
+        const r = spawnSync("pnpm", ["root", "-g"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) candidates.push({ manager: "pnpm", dir: r.stdout.trim() });
+      } catch {
+      }
+      try {
+        const r = spawnSync("yarn", ["global", "dir"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) {
+          candidates.push({ manager: "yarn", dir: path2.join(r.stdout.trim(), "node_modules") });
+        }
+      } catch {
+      }
+      try {
+        const r = spawnSync("bun", ["pm", "bin", "-g"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) {
+          candidates.push({ manager: "bun", dir: path2.join(home, ".bun", "install", "global", "node_modules") });
+        }
+      } catch {
+      }
+      const nvmRoot = path2.join(home, ".nvm", "versions", "node");
+      if (exists(nvmRoot)) {
+        for (const v of readDirSafe(nvmRoot)) {
+          const dir = path2.join(nvmRoot, v, "lib", "node_modules");
+          if (exists(dir) && !candidates.some((c) => c.dir === dir)) {
+            candidates.push({ manager: `nvm/${v}`, dir });
+          }
+        }
+      }
+      return candidates;
+    }
+    function findRihalPackages(globalNodeModules) {
+      const found = [];
+      for (const scope of ["@hanzlaa", "@hanzlahabib"]) {
+        const scopeDir = path2.join(globalNodeModules, scope);
+        if (!exists(scopeDir)) continue;
+        for (const pkg of readDirSafe(scopeDir)) {
+          if (pkg === "rcode" || pkg === "rihal-code" || pkg.startsWith("rihal")) {
+            found.push({ scope, pkg, dir: path2.join(scopeDir, pkg) });
+          }
+        }
+      }
+      return found;
+    }
+    function getGlobalBinDirs() {
+      const home = os.homedir();
+      const dirs = /* @__PURE__ */ new Set();
+      try {
+        const r = spawnSync("npm", ["prefix", "-g"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) dirs.add(path2.join(r.stdout.trim(), "bin"));
+      } catch {
+      }
+      try {
+        const r = spawnSync("pnpm", ["bin", "-g"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) dirs.add(r.stdout.trim());
+      } catch {
+      }
+      try {
+        const r = spawnSync("yarn", ["global", "bin"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) dirs.add(r.stdout.trim());
+      } catch {
+      }
+      try {
+        const r = spawnSync("bun", ["pm", "bin", "-g"], { encoding: "utf8" });
+        if (r.status === 0 && r.stdout.trim()) dirs.add(r.stdout.trim());
+      } catch {
+      }
+      dirs.add(path2.join(home, ".local", "share", "pnpm"));
+      dirs.add(path2.join(home, ".local", "bin"));
+      dirs.add(path2.join(home, ".bun", "bin"));
+      const nvmRoot = path2.join(home, ".nvm", "versions", "node");
+      if (exists(nvmRoot)) {
+        for (const v of readDirSafe(nvmRoot)) {
+          dirs.add(path2.join(nvmRoot, v, "bin"));
+        }
+      }
+      return [...dirs].filter(exists);
+    }
+    var RCODE_BINS = ["rcode", "rihal", "rihal-code"];
+    function findRihalBins(binDir) {
+      const found = [];
+      for (const name of RCODE_BINS) {
+        const p = path2.join(binDir, name);
+        if (exists(p)) {
+          let target = null;
+          try {
+            target = fs2.readlinkSync(p);
+          } catch {
+          }
+          if (!target || /rcode|rihal-code|@hanzlaa|@hanzlahabib/.test(target)) {
+            found.push({ name, path: p, target });
+          }
+        }
+      }
+      return found;
+    }
+    function findClaudeArtifacts(claudeDir) {
+      const found = [];
+      if (!exists(claudeDir)) return found;
+      const cmdRoot = path2.join(claudeDir, "commands");
+      if (exists(cmdRoot)) {
+        for (const f of readDirSafe(cmdRoot)) {
+          if (f.startsWith("rihal-") && (f.endsWith(".md") || f.endsWith(".mdc"))) {
+            found.push({ kind: "command", path: path2.join(cmdRoot, f) });
+          }
+        }
+        const rihalSubdir = path2.join(cmdRoot, "rihal");
+        if (exists(rihalSubdir)) {
+          found.push({ kind: "commands-dir", path: rihalSubdir });
+        }
+      }
+      const agentsDir = path2.join(claudeDir, "agents");
+      if (exists(agentsDir)) {
+        for (const f of readDirSafe(agentsDir)) {
+          if (f.startsWith("rihal-") && (f.endsWith(".md") || f.endsWith(".mdc"))) {
+            found.push({ kind: "agent", path: path2.join(agentsDir, f) });
+          }
+        }
+      }
+      const skillsDir = path2.join(claudeDir, "skills");
+      if (exists(skillsDir)) {
+        for (const d of readDirSafe(skillsDir)) {
+          if (d.startsWith("rihal-")) {
+            found.push({ kind: "skill-dir", path: path2.join(skillsDir, d) });
+          }
+        }
+      }
+      return found;
+    }
+    function buildPlan({ includePlanning }) {
+      const home = os.homedir();
+      const cwd = process.cwd();
+      const plan = {
+        packages: [],
+        bins: [],
+        globalClaude: [],
+        globalRihal: null,
+        projectClaude: [],
+        projectRihal: null,
+        projectPlanning: null
+      };
+      for (const { manager, dir } of getGlobalNodeModulesDirs()) {
+        for (const pkg of findRihalPackages(dir)) {
+          plan.packages.push({ manager, ...pkg });
+        }
+      }
+      for (const binDir of getGlobalBinDirs()) {
+        for (const bin of findRihalBins(binDir)) {
+          plan.bins.push({ binDir, ...bin });
+        }
+      }
+      plan.globalClaude = findClaudeArtifacts(path2.join(home, ".claude"));
+      const globalRihal = path2.join(home, ".rihal");
+      if (exists(globalRihal)) plan.globalRihal = globalRihal;
+      plan.projectClaude = findClaudeArtifacts(path2.join(cwd, ".claude"));
+      const projectRihal = path2.join(cwd, ".rihal");
+      if (exists(projectRihal) && cwd !== home) plan.projectRihal = projectRihal;
+      if (includePlanning) {
+        const projectPlanning = path2.join(cwd, ".planning");
+        if (exists(projectPlanning) && cwd !== home) plan.projectPlanning = projectPlanning;
+      }
+      return plan;
+    }
+    function printPlan(plan, { dryRun }) {
+      const banner = dryRun ? "[DRY RUN \u2014 pass --yes to remove]" : "[REMOVING]";
+      console.log(`
+\u{1F525} rcode nuke ${banner}
+`);
+      let total = 0;
+      const section = (title, items) => {
+        if (!items || Array.isArray(items) && items.length === 0) return;
+        console.log(`${title}`);
+        if (Array.isArray(items)) {
+          for (const item of items) {
+            console.log(`  \u2022 ${item.description || item.path || item.dir || JSON.stringify(item)}`);
+            total++;
+          }
+        } else {
+          console.log(`  \u2022 ${items}`);
+          total++;
+        }
+        console.log("");
+      };
+      section("\u{1F4E6} Global packages (node_modules):", plan.packages.map((p) => ({
+        description: `[${p.manager}] ${p.scope}/${p.pkg}  \u2192  ${p.dir}`
+      })));
+      section("\u{1F517} Global binaries:", plan.bins.map((b) => ({
+        description: `${b.path}${b.target ? `  \u2192  ${b.target}` : ""}`
+      })));
+      section("\u{1F916} ~/.claude/ artifacts:", plan.globalClaude.map((a) => ({
+        description: `[${a.kind}] ${a.path}`
+      })));
+      if (plan.globalRihal) section("\u{1F5C2}\uFE0F  ~/.rihal/ (global state):", plan.globalRihal);
+      section("\u{1F916} ./.claude/ artifacts (current project):", plan.projectClaude.map((a) => ({
+        description: `[${a.kind}] ${a.path}`
+      })));
+      if (plan.projectRihal) section("\u{1F5C2}\uFE0F  ./.rihal/ (project state):", plan.projectRihal);
+      if (plan.projectPlanning) section("\u{1F4CB} ./.planning/ (your work \u2014 only with --include-planning):", plan.projectPlanning);
+      if (total === 0) {
+        console.log("  \u2713 nothing to remove \u2014 system is clean.\n");
+      } else {
+        console.log(`  Total: ${total} item(s).
+`);
+      }
+      return total;
+    }
+    function rmrf(p) {
+      try {
+        fs2.rmSync(p, { recursive: true, force: true });
+        return true;
+      } catch (err) {
+        console.warn(`  \u26A0 failed to remove ${p}: ${err.message}`);
+        return false;
+      }
+    }
+    function uninstallPackage(manager, scope, pkg) {
+      const fullName = `${scope}/${pkg}`;
+      const cmd = manager === "pnpm" ? ["pnpm", ["remove", "-g", fullName]] : manager === "yarn" ? ["yarn", ["global", "remove", fullName]] : manager === "bun" ? ["bun", ["remove", "-g", fullName]] : ["npm", ["uninstall", "-g", fullName]];
+      try {
+        const r = spawnSync(cmd[0], cmd[1], { stdio: "pipe", encoding: "utf8" });
+        return r.status === 0;
+      } catch {
+        return false;
+      }
+    }
+    function executePlan(plan) {
+      let removed = 0;
+      for (const p of plan.packages) {
+        const manager = p.manager.startsWith("nvm/") ? "npm" : p.manager;
+        process.stdout.write(`  ${manager} uninstall ${p.scope}/${p.pkg} ... `);
+        const ok = uninstallPackage(manager, p.scope, p.pkg);
+        console.log(ok ? "\u2713" : "\u26A0 failed via PM, falling back to rm");
+        if (!ok) rmrf(p.dir);
+        removed++;
+      }
+      for (const b of plan.bins) {
+        if (exists(b.path)) {
+          if (rmrf(b.path)) {
+            console.log(`  \u2713 removed bin ${b.path}`);
+            removed++;
+          }
+        }
+      }
+      for (const a of plan.globalClaude) {
+        if (rmrf(a.path)) {
+          console.log(`  \u2713 removed ${a.path}`);
+          removed++;
+        }
+      }
+      if (plan.globalRihal && rmrf(plan.globalRihal)) {
+        console.log(`  \u2713 removed ${plan.globalRihal}`);
+        removed++;
+      }
+      for (const a of plan.projectClaude) {
+        if (rmrf(a.path)) {
+          console.log(`  \u2713 removed ${a.path}`);
+          removed++;
+        }
+      }
+      if (plan.projectRihal && rmrf(plan.projectRihal)) {
+        console.log(`  \u2713 removed ${plan.projectRihal}`);
+        removed++;
+      }
+      if (plan.projectPlanning && rmrf(plan.projectPlanning)) {
+        console.log(`  \u2713 removed ${plan.projectPlanning}`);
+        removed++;
+      }
+      return removed;
+    }
+    module2.exports = function nuke(args = []) {
+      const dryRun = !args.includes("--yes") && !args.includes("-y");
+      const includePlanning = args.includes("--include-planning");
+      const cwdPkgJson = path2.join(process.cwd(), "package.json");
+      if (exists(cwdPkgJson)) {
+        try {
+          const pkg = JSON.parse(fs2.readFileSync(cwdPkgJson, "utf8"));
+          if (pkg.name === "@hanzlaa/rcode" || pkg.name === "@hanzlahabib/rihal-code") {
+            console.log("\n\u26A0  You are inside the rcode source repo.");
+            console.log("   Nuke would remove this repo's .claude/, .rihal/, and possibly .planning/.");
+            console.log("   That is your source code \u2014 almost certainly not what you want.");
+            console.log("   Run nuke from a different directory, or pass --i-know-what-im-doing to override.\n");
+            if (!args.includes("--i-know-what-im-doing")) return;
+          }
+        } catch {
+        }
+      }
+      const plan = buildPlan({ includePlanning });
+      const total = printPlan(plan, { dryRun });
+      if (total === 0 || dryRun) {
+        if (dryRun && total > 0) {
+          console.log("To actually remove these, re-run with:  rcode nuke --yes");
+          console.log("To also remove .planning/ (your work):  rcode nuke --yes --include-planning\n");
+        }
+        return;
+      }
+      console.log("Executing...\n");
+      const removed = executePlan(plan);
+      console.log(`
+\u2705 Done. Removed ${removed} item(s). Reinstall:  npm install -g @hanzlaa/rcode
+`);
+    };
+  }
+});
+
 // cli/dashboard.js
 var require_dashboard = __commonJS({
   "cli/dashboard.js"(exports2, module2) {
@@ -18483,6 +18864,65 @@ var require_doctor = __commonJS({
       }
       return failing;
     }
+    function checkDuplicateInstalls() {
+      const os = require("os");
+      const home = os.homedir();
+      const installs = [];
+      const dirs = [];
+      for (const cmd of [["npm", ["root", "-g"]], ["pnpm", ["root", "-g"]]]) {
+        try {
+          const r = spawnSync(cmd[0], cmd[1], { encoding: "utf8" });
+          if (r.status === 0 && r.stdout.trim()) dirs.push({ manager: cmd[0], dir: r.stdout.trim() });
+        } catch {
+        }
+      }
+      const nvmRoot = path2.join(home, ".nvm", "versions", "node");
+      if (fs2.existsSync(nvmRoot)) {
+        for (const v of fs2.readdirSync(nvmRoot)) {
+          const dir = path2.join(nvmRoot, v, "lib", "node_modules");
+          if (fs2.existsSync(dir) && !dirs.some((d) => d.dir === dir)) {
+            dirs.push({ manager: `nvm/${v}`, dir });
+          }
+        }
+      }
+      for (const { manager, dir } of dirs) {
+        for (const scope of ["@hanzlaa", "@hanzlahabib"]) {
+          const scopeDir = path2.join(dir, scope);
+          if (!fs2.existsSync(scopeDir)) continue;
+          for (const pkg of fs2.readdirSync(scopeDir)) {
+            if (pkg === "rcode" || pkg === "rihal-code" || pkg.startsWith("rihal")) {
+              let version = "unknown";
+              try {
+                const pkgJson = JSON.parse(fs2.readFileSync(path2.join(scopeDir, pkg, "package.json"), "utf8"));
+                version = pkgJson.version;
+              } catch {
+              }
+              installs.push({ manager, scope, pkg, version, dir: path2.join(scopeDir, pkg) });
+            }
+          }
+        }
+      }
+      return { count: installs.length, installs };
+    }
+    function printDuplicateChecks(result) {
+      if (result.count === 0) {
+        console.log(`   \u2713 No global rcode installs found`);
+        return 0;
+      }
+      if (result.count === 1) {
+        const i = result.installs[0];
+        console.log(`   \u2713 Single global install: [${i.manager}] ${i.scope}/${i.pkg}@${i.version}`);
+        return 0;
+      }
+      console.log(`   \u2717 ${result.count} global installs detected \u2014 this causes duplicate slash commands!`);
+      for (const i of result.installs) {
+        console.log(`     [${i.manager}] ${i.scope}/${i.pkg}@${i.version}`);
+        console.log(`       ${i.dir}`);
+      }
+      console.log(`
+     Fix: rcode nuke --yes && npm install -g @hanzlaa/rcode`);
+      return 1;
+    }
     module2.exports = function doctor(args, { packageRoot }) {
       const cwd = process.cwd();
       console.log(`
@@ -18492,9 +18932,13 @@ var require_doctor = __commonJS({
       const checks = runPreflight(cwd, packageRoot);
       const preflightFailures = printChecks(checks);
       console.log(`
+Duplicate installations:`);
+      const dupResult = checkDuplicateInstalls();
+      const duplicateFailures = printDuplicateChecks(dupResult);
+      console.log(`
 Package compliance:`);
       const complianceFailures = runCompliance(packageRoot);
-      const totalFailures = preflightFailures + complianceFailures;
+      const totalFailures = preflightFailures + complianceFailures + duplicateFailures;
       console.log();
       if (totalFailures === 0) {
         console.log(`\u2705 All checks passed.`);
@@ -20436,6 +20880,8 @@ var COMMANDS = {
   uninstall: require_uninstall(),
   remove: require_uninstall(),
   // alias
+  nuke: require_nuke(),
+  // full cleanup across all package managers + global state
   dashboard: require_dashboard(),
   serve: require_dashboard(),
   digest: require_digest(),
@@ -20467,6 +20913,10 @@ Usage:
   update         Refresh skill files (backs up .rihal/ state first)
   uninstall      Remove Rihal Code from the current project
   remove         Alias for uninstall
+  nuke           Wipe ALL rihal/rcode installs everywhere (global packages,
+                 binaries, ~/.claude/* rihal artifacts, ~/.rihal/, project artifacts)
+                 Default = dry-run. Pass --yes to remove. Pass --include-planning
+                 to also remove .planning/ in CWD.
   config         Get/set project configuration (project_name, user_name, etc.)
   context        Memory bank freshness (--check | --refresh | --install-hook)
   github-sync    Sync .rihal/ phases/epics/stories to GitHub (dry-run default)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "3.4.15",
+  "version": "3.4.17",
   "description": "rcode — the memory bank for AI-driven SaaS teams. Persistent project context, distinctive engineering personas, and phase-based workflows. Built by Rihal. Works in Claude Code, Cursor, Gemini, VS Code, and Antigravity.",
   "main": "cli/index.js",
   "bin": {