cc-plan-viewer 0.2.1 → 0.2.3

package/README.md

@@ -1,4 +1,4 @@
-# cc-plan-viewer
+# Claude Code Plan Viewer
 
 A browser-based review UI for Claude Code plans. When Claude Code enters plan mode, a browser tab opens automatically showing the plan with proper markdown rendering, syntax highlighting, and inline commenting.
 

package/dist/cli-bundle.mjs

@@ -27498,7 +27498,8 @@ var init_lifecycle = __esm({
 import { createServer } from "node:http";
 import fs3 from "node:fs";
 import path3 from "node:path";
-function createApp(plansDirs2) {
+function createApp(initialPlansDirs) {
+  const plansDirs2 = [...initialPlansDirs];
   const plansDir = plansDirs2[0] || "";
   const app = (0, import_express.default)();
   const server2 = createServer(app);
@@ -27569,6 +27570,10 @@ function createApp(plansDirs2) {
   app.post("/api/plan-updated", (req, res) => {
     const { filePath, planOptions } = req.body;
     const filename = path3.basename(filePath || "");
+    const dir = path3.dirname(filePath || "");
+    if (dir && !plansDirs2.includes(dir) && fs3.existsSync(dir)) {
+      plansDirs2.push(dir);
+    }
     const message = JSON.stringify({
       type: "plan-updated",
       filename,
@@ -27755,6 +27760,7 @@ var init_server = __esm({
 import fs6 from "node:fs";
 import path6 from "node:path";
 import os3 from "node:os";
+import readline from "node:readline";
 import { execSync } from "node:child_process";
 var INSTALL_DIR = path6.join(os3.homedir(), ".cc-plan-viewer");
 var INSTALLED_HOOK = path6.join(INSTALL_DIR, "plan-viewer-hook.cjs");
@@ -27769,18 +27775,6 @@ function getPkgRoot() {
   return PKG_ROOT_DEV;
 }
 var DEFAULT_SETTINGS = path6.join(os3.homedir(), ".claude", "settings.json");
-function resolveSettingsPath() {
-  const configIdx = process.argv.indexOf("--config");
-  if (configIdx !== -1 && process.argv[configIdx + 1]) {
-    const custom = path6.resolve(process.argv[configIdx + 1]);
-    if (!fs6.existsSync(path6.dirname(custom))) {
-      console.error(`[cc-plan-viewer] Directory does not exist: ${path6.dirname(custom)}`);
-      process.exit(1);
-    }
-    return custom;
-  }
-  return DEFAULT_SETTINGS;
-}
 function readSettings(settingsPath) {
   try {
     return JSON.parse(fs6.readFileSync(settingsPath, "utf8"));
@@ -27794,6 +27788,131 @@ function writeSettings(settingsPath, settings) {
     fs6.mkdirSync(dir, { recursive: true });
   fs6.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
 }
+function findAllClaudeSettings() {
+  const home = os3.homedir();
+  const found = /* @__PURE__ */ new Set();
+  try {
+    for (const name of fs6.readdirSync(home)) {
+      if (!name.startsWith(".claude"))
+        continue;
+      const candidate = path6.join(home, name, "settings.json");
+      if (fs6.existsSync(candidate))
+        found.add(candidate);
+    }
+  } catch {
+  }
+  if (process.env.CLAUDE_CONFIG_DIR) {
+    const candidate = path6.join(process.env.CLAUDE_CONFIG_DIR, "settings.json");
+    if (fs6.existsSync(candidate))
+      found.add(candidate);
+  }
+  return [...found].sort();
+}
+function tildePath(p) {
+  return p.replace(os3.homedir(), "~");
+}
+async function promptMultiSelect(options, question, activeConfigDir) {
+  if (!process.stdin.isTTY) {
+    if (activeConfigDir) {
+      const match = options.findIndex((p) => p.startsWith(activeConfigDir));
+      return match >= 0 ? [match] : [0];
+    }
+    return options.map((_, i) => i);
+  }
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  console.log("");
+  console.log(`[cc-plan-viewer] Found ${options.length} Claude config directories:`);
+  options.forEach((opt, i) => {
+    const active = activeConfigDir && opt.startsWith(activeConfigDir) ? " (active)" : "";
+    console.log(`  ${i + 1}. ${tildePath(opt)}${active}`);
+  });
+  console.log("");
+  return new Promise((resolve) => {
+    rl.question(`${question} (comma-separated numbers, or "all"): `, (answer) => {
+      rl.close();
+      const trimmed = answer.trim().toLowerCase();
+      if (trimmed === "all" || trimmed === "") {
+        resolve(options.map((_, i) => i));
+        return;
+      }
+      const indices = trimmed.split(",").map((s) => parseInt(s.trim(), 10) - 1).filter((i) => i >= 0 && i < options.length);
+      resolve(indices);
+    });
+  });
+}
+function addHookToSettings(settingsPath) {
+  const settings = readSettings(settingsPath);
+  if (!settings.hooks || typeof settings.hooks !== "object") {
+    settings.hooks = {};
+  }
+  const hooks = settings.hooks;
+  if (!Array.isArray(hooks.PostToolUse)) {
+    hooks.PostToolUse = [];
+  }
+  const hookCommand = getHookCommand();
+  hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
+    if (typeof entry !== "object" || entry === null)
+      return true;
+    const e = entry;
+    if (!Array.isArray(e.hooks))
+      return true;
+    return !e.hooks.some((h) => {
+      if (typeof h !== "object" || h === null)
+        return false;
+      const cmd = h.command;
+      return typeof cmd === "string" && cmd.includes("plan-viewer-hook");
+    });
+  });
+  hooks.PostToolUse.push({
+    matcher: "Write|Edit",
+    hooks: [{ type: "command", command: hookCommand }]
+  });
+  writeSettings(settingsPath, settings);
+}
+function removeHookFromSettings(settingsPath) {
+  const settings = readSettings(settingsPath);
+  const hooks = settings.hooks;
+  if (!hooks?.PostToolUse || !Array.isArray(hooks.PostToolUse))
+    return false;
+  const before = hooks.PostToolUse.length;
+  hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
+    if (typeof entry !== "object" || entry === null)
+      return true;
+    const e = entry;
+    if (!Array.isArray(e.hooks))
+      return true;
+    return !e.hooks.some((h) => {
+      if (typeof h !== "object" || h === null)
+        return false;
+      const cmd = h.command;
+      return typeof cmd === "string" && cmd.includes("plan-viewer-hook");
+    });
+  });
+  if (hooks.PostToolUse.length < before) {
+    writeSettings(settingsPath, settings);
+    return true;
+  }
+  return false;
+}
+function settingsHasHook(settingsPath) {
+  const settings = readSettings(settingsPath);
+  const hooks = settings.hooks;
+  if (!hooks?.PostToolUse || !Array.isArray(hooks.PostToolUse))
+    return false;
+  return hooks.PostToolUse.some((entry) => {
+    if (typeof entry !== "object" || entry === null)
+      return false;
+    const e = entry;
+    if (!Array.isArray(e.hooks))
+      return false;
+    return e.hooks.some((h) => {
+      if (typeof h !== "object" || h === null)
+        return false;
+      const cmd = h.command;
+      return typeof cmd === "string" && cmd.includes("plan-viewer-hook");
+    });
+  });
+}
 function copyDir(src, dest) {
   if (!fs6.existsSync(src))
     return;
@@ -27836,50 +27955,48 @@ function installFiles() {
 function getHookCommand() {
   return `node "${INSTALLED_HOOK}"`;
 }
-function install() {
-  const settingsPath = resolveSettingsPath();
+async function install() {
   console.log("[cc-plan-viewer] Installing...");
   console.log(`[cc-plan-viewer] Install dir: ${INSTALL_DIR}`);
-  console.log(`[cc-plan-viewer] Settings: ${settingsPath}`);
   installFiles();
   console.log("[cc-plan-viewer] Files copied to ~/.cc-plan-viewer/");
   patchHookPaths();
-  const settings = readSettings(settingsPath);
-  if (!settings.hooks || typeof settings.hooks !== "object") {
-    settings.hooks = {};
-  }
-  const hooks = settings.hooks;
-  if (!Array.isArray(hooks.PostToolUse)) {
-    hooks.PostToolUse = [];
+  const configIdx = process.argv.indexOf("--config");
+  if (configIdx !== -1 && process.argv[configIdx + 1]) {
+    const settingsPath = path6.resolve(process.argv[configIdx + 1]);
+    if (!fs6.existsSync(path6.dirname(settingsPath))) {
+      console.error(`[cc-plan-viewer] Directory does not exist: ${path6.dirname(settingsPath)}`);
+      process.exit(1);
+    }
+    addHookToSettings(settingsPath);
+    console.log(`[cc-plan-viewer] Hook added to ${tildePath(settingsPath)}`);
+  } else {
+    const allSettings = findAllClaudeSettings();
+    if (allSettings.length === 0) {
+      addHookToSettings(DEFAULT_SETTINGS);
+      console.log(`[cc-plan-viewer] Hook added to ${tildePath(DEFAULT_SETTINGS)}`);
+    } else if (allSettings.length === 1) {
+      addHookToSettings(allSettings[0]);
+      console.log(`[cc-plan-viewer] Hook added to ${tildePath(allSettings[0])}`);
+    } else {
+      const selected = await promptMultiSelect(allSettings, "Install hook in which configs?", process.env.CLAUDE_CONFIG_DIR);
+      if (selected.length === 0) {
+        console.log("[cc-plan-viewer] No configs selected. Hook not installed.");
+        return;
+      }
+      for (const idx of selected) {
+        addHookToSettings(allSettings[idx]);
+        console.log(`[cc-plan-viewer] Hook added to ${tildePath(allSettings[idx])}`);
+      }
+    }
   }
-  const hookCommand = getHookCommand();
-  hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
-    if (typeof entry !== "object" || entry === null)
-      return true;
-    const e = entry;
-    if (!Array.isArray(e.hooks))
-      return true;
-    return !e.hooks.some((h) => {
-      if (typeof h !== "object" || h === null)
-        return false;
-      const cmd = h.command;
-      return typeof cmd === "string" && cmd.includes("plan-viewer-hook");
-    });
-  });
-  hooks.PostToolUse.push({
-    matcher: "Write|Edit",
-    hooks: [{ type: "command", command: hookCommand }]
-  });
-  writeSettings(settingsPath, settings);
+  console.log("");
   console.log("[cc-plan-viewer] Hook installed successfully.");
   console.log("");
   console.log("  Next time Claude Code writes a plan, the viewer will open in your browser.");
   console.log("");
   console.log("  Update anytime:   npx cc-plan-viewer@latest update");
   console.log("  Uninstall:        npx cc-plan-viewer uninstall");
-  if (settingsPath !== DEFAULT_SETTINGS) {
-    console.log(`  Custom config:    ${settingsPath}`);
-  }
 }
 function patchHookPaths() {
   if (!fs6.existsSync(INSTALLED_HOOK))
@@ -27915,29 +28032,28 @@ function update() {
   }
   console.log("[cc-plan-viewer] Files updated in ~/.cc-plan-viewer/");
 }
-function uninstall() {
-  const settingsPath = resolveSettingsPath();
+async function uninstall() {
   console.log("[cc-plan-viewer] Uninstalling...");
-  const settings = readSettings(settingsPath);
-  const hooks = settings.hooks;
-  if (hooks?.PostToolUse && Array.isArray(hooks.PostToolUse)) {
-    const before = hooks.PostToolUse.length;
-    hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
-      if (typeof entry !== "object" || entry === null)
-        return true;
-      const e = entry;
-      if (!Array.isArray(e.hooks))
-        return true;
-      return !e.hooks.some((h) => {
-        if (typeof h !== "object" || h === null)
-          return false;
-        const cmd = h.command;
-        return typeof cmd === "string" && cmd.includes("plan-viewer-hook");
-      });
-    });
-    if (hooks.PostToolUse.length < before) {
-      writeSettings(settingsPath, settings);
-      console.log(`[cc-plan-viewer] Hook removed from ${settingsPath}`);
+  const configIdx = process.argv.indexOf("--config");
+  if (configIdx !== -1 && process.argv[configIdx + 1]) {
+    const settingsPath = path6.resolve(process.argv[configIdx + 1]);
+    if (removeHookFromSettings(settingsPath)) {
+      console.log(`[cc-plan-viewer] Hook removed from ${tildePath(settingsPath)}`);
+    }
+  } else {
+    const allSettings = findAllClaudeSettings();
+    const withHook = allSettings.filter(settingsHasHook);
+    if (withHook.length === 0) {
+      console.log("[cc-plan-viewer] No hooks found in any Claude config.");
+    } else if (withHook.length === 1) {
+      removeHookFromSettings(withHook[0]);
+      console.log(`[cc-plan-viewer] Hook removed from ${tildePath(withHook[0])}`);
+    } else {
+      const selected = await promptMultiSelect(withHook, "Remove hook from which configs?");
+      for (const idx of selected) {
+        removeHookFromSettings(withHook[idx]);
+        console.log(`[cc-plan-viewer] Hook removed from ${tildePath(withHook[idx])}`);
+      }
     }
   }
   if (fs6.existsSync(INSTALL_DIR)) {
@@ -27977,13 +28093,13 @@ function version() {
 var command = process.argv[2];
 switch (command) {
   case "install":
-    install();
+    await install();
     break;
   case "update":
     update();
     break;
   case "uninstall":
-    uninstall();
+    await uninstall();
     break;
   case "start":
     start();
@@ -27999,11 +28115,14 @@ switch (command) {
 cc-plan-viewer \u2014 Browser-based review UI for Claude Code plans
 
 Usage:
-  npx cc-plan-viewer install              Install hook + viewer files
-  npx cc-plan-viewer install --config <path>  Use custom settings.json path
-  npx cc-plan-viewer@latest update        Update to latest version
-  npx cc-plan-viewer uninstall            Remove hook + viewer files
-  npx cc-plan-viewer version              Show installed version
+  npx cc-plan-viewer install                  Install hook + viewer files
+  npx cc-plan-viewer install --config <path>  Use specific settings.json path
+  npx cc-plan-viewer@latest update            Update to latest version
+  npx cc-plan-viewer uninstall                Remove hook + viewer files
+  npx cc-plan-viewer version                  Show installed version
+
+When multiple Claude configs are detected (~/.claude*/settings.json),
+you'll be prompted to choose which ones to install the hook in.
 
 Files are installed to ~/.cc-plan-viewer/ so they persist across npm cache clears.
 `);

package/dist/server/bin/cc-plan-viewer.js

@@ -2,6 +2,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
+import readline from 'node:readline';
 import { execSync } from 'node:child_process';
 // ─── Stable install location ───
 const INSTALL_DIR = path.join(os.homedir(), '.cc-plan-viewer');
@@ -23,19 +24,6 @@ function getPkgRoot() {
 }
 // ─── Settings file resolution ───
 const DEFAULT_SETTINGS = path.join(os.homedir(), '.claude', 'settings.json');
-function resolveSettingsPath() {
-    // Check --config flag
-    const configIdx = process.argv.indexOf('--config');
-    if (configIdx !== -1 && process.argv[configIdx + 1]) {
-        const custom = path.resolve(process.argv[configIdx + 1]);
-        if (!fs.existsSync(path.dirname(custom))) {
-            console.error(`[cc-plan-viewer] Directory does not exist: ${path.dirname(custom)}`);
-            process.exit(1);
-        }
-        return custom;
-    }
-    return DEFAULT_SETTINGS;
-}
 function readSettings(settingsPath) {
     try {
         return JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
@@ -50,6 +38,139 @@ function writeSettings(settingsPath, settings) {
         fs.mkdirSync(dir, { recursive: true });
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
 }
+// ─── Multi-config detection ───
+function findAllClaudeSettings() {
+    const home = os.homedir();
+    const found = new Set();
+    // Scan ~/.claude*/settings.json
+    try {
+        for (const name of fs.readdirSync(home)) {
+            if (!name.startsWith('.claude'))
+                continue;
+            const candidate = path.join(home, name, 'settings.json');
+            if (fs.existsSync(candidate))
+                found.add(candidate);
+        }
+    }
+    catch { }
+    // Include CLAUDE_CONFIG_DIR if set (may point outside ~/.claude*)
+    if (process.env.CLAUDE_CONFIG_DIR) {
+        const candidate = path.join(process.env.CLAUDE_CONFIG_DIR, 'settings.json');
+        if (fs.existsSync(candidate))
+            found.add(candidate);
+    }
+    return [...found].sort();
+}
+function tildePath(p) {
+    return p.replace(os.homedir(), '~');
+}
+async function promptMultiSelect(options, question, activeConfigDir) {
+    // Non-interactive: fall back to CLAUDE_CONFIG_DIR or all
+    if (!process.stdin.isTTY) {
+        if (activeConfigDir) {
+            const match = options.findIndex(p => p.startsWith(activeConfigDir));
+            return match >= 0 ? [match] : [0];
+        }
+        return options.map((_, i) => i);
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log('');
+    console.log(`[cc-plan-viewer] Found ${options.length} Claude config directories:`);
+    options.forEach((opt, i) => {
+        const active = activeConfigDir && opt.startsWith(activeConfigDir) ? ' (active)' : '';
+        console.log(`  ${i + 1}. ${tildePath(opt)}${active}`);
+    });
+    console.log('');
+    return new Promise((resolve) => {
+        rl.question(`${question} (comma-separated numbers, or "all"): `, (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            if (trimmed === 'all' || trimmed === '') {
+                resolve(options.map((_, i) => i));
+                return;
+            }
+            const indices = trimmed.split(',')
+                .map(s => parseInt(s.trim(), 10) - 1)
+                .filter(i => i >= 0 && i < options.length);
+            resolve(indices);
+        });
+    });
+}
+function addHookToSettings(settingsPath) {
+    const settings = readSettings(settingsPath);
+    if (!settings.hooks || typeof settings.hooks !== 'object') {
+        settings.hooks = {};
+    }
+    const hooks = settings.hooks;
+    if (!Array.isArray(hooks.PostToolUse)) {
+        hooks.PostToolUse = [];
+    }
+    const hookCommand = getHookCommand();
+    // Remove any existing cc-plan-viewer hooks first (handles upgrades)
+    hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return true;
+        const e = entry;
+        if (!Array.isArray(e.hooks))
+            return true;
+        return !e.hooks.some((h) => {
+            if (typeof h !== 'object' || h === null)
+                return false;
+            const cmd = h.command;
+            return typeof cmd === 'string' && cmd.includes('plan-viewer-hook');
+        });
+    });
+    // Add fresh hook entry
+    hooks.PostToolUse.push({
+        matcher: 'Write|Edit',
+        hooks: [{ type: 'command', command: hookCommand }],
+    });
+    writeSettings(settingsPath, settings);
+}
+function removeHookFromSettings(settingsPath) {
+    const settings = readSettings(settingsPath);
+    const hooks = settings.hooks;
+    if (!hooks?.PostToolUse || !Array.isArray(hooks.PostToolUse))
+        return false;
+    const before = hooks.PostToolUse.length;
+    hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return true;
+        const e = entry;
+        if (!Array.isArray(e.hooks))
+            return true;
+        return !e.hooks.some((h) => {
+            if (typeof h !== 'object' || h === null)
+                return false;
+            const cmd = h.command;
+            return typeof cmd === 'string' && cmd.includes('plan-viewer-hook');
+        });
+    });
+    if (hooks.PostToolUse.length < before) {
+        writeSettings(settingsPath, settings);
+        return true;
+    }
+    return false;
+}
+function settingsHasHook(settingsPath) {
+    const settings = readSettings(settingsPath);
+    const hooks = settings.hooks;
+    if (!hooks?.PostToolUse || !Array.isArray(hooks.PostToolUse))
+        return false;
+    return hooks.PostToolUse.some((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return false;
+        const e = entry;
+        if (!Array.isArray(e.hooks))
+            return false;
+        return e.hooks.some((h) => {
+            if (typeof h !== 'object' || h === null)
+                return false;
+            const cmd = h.command;
+            return typeof cmd === 'string' && cmd.includes('plan-viewer-hook');
+        });
+    });
+}
 // ─── Copy files to stable location ───
 function copyDir(src, dest) {
     if (!fs.existsSync(src))
@@ -100,60 +221,57 @@ function installFiles() {
 function getHookCommand() {
     return `node "${INSTALLED_HOOK}"`;
 }
-function install() {
-    const settingsPath = resolveSettingsPath();
+async function install() {
     console.log('[cc-plan-viewer] Installing...');
     console.log(`[cc-plan-viewer] Install dir: ${INSTALL_DIR}`);
-    console.log(`[cc-plan-viewer] Settings: ${settingsPath}`);
     // Copy files to stable location
     installFiles();
     console.log('[cc-plan-viewer] Files copied to ~/.cc-plan-viewer/');
-    // Patch the installed hook to know where the server is
-    // The hook uses __dirname to find the server — now it's in ~/.cc-plan-viewer/
-    // and the server is at ~/.cc-plan-viewer/server/server/index.js
-    // Hook already resolves path.join(__dirname, '..', 'dist', 'server', 'server', 'index.js')
-    // but now it should look at path.join(__dirname, '..', 'server', 'server', 'index.js')
-    // Let's patch the hook to check both locations
     patchHookPaths();
-    // Add hook to settings
-    const settings = readSettings(settingsPath);
-    if (!settings.hooks || typeof settings.hooks !== 'object') {
-        settings.hooks = {};
+    // Determine which settings files to update
+    const configIdx = process.argv.indexOf('--config');
+    if (configIdx !== -1 && process.argv[configIdx + 1]) {
+        // Explicit --config flag: use exactly that path
+        const settingsPath = path.resolve(process.argv[configIdx + 1]);
+        if (!fs.existsSync(path.dirname(settingsPath))) {
+            console.error(`[cc-plan-viewer] Directory does not exist: ${path.dirname(settingsPath)}`);
+            process.exit(1);
+        }
+        addHookToSettings(settingsPath);
+        console.log(`[cc-plan-viewer] Hook added to ${tildePath(settingsPath)}`);
     }
-    const hooks = settings.hooks;
-    if (!Array.isArray(hooks.PostToolUse)) {
-        hooks.PostToolUse = [];
+    else {
+        const allSettings = findAllClaudeSettings();
+        if (allSettings.length === 0) {
+            // No existing configs — create default
+            addHookToSettings(DEFAULT_SETTINGS);
+            console.log(`[cc-plan-viewer] Hook added to ${tildePath(DEFAULT_SETTINGS)}`);
+        }
+        else if (allSettings.length === 1) {
+            // Single config — use it directly
+            addHookToSettings(allSettings[0]);
+            console.log(`[cc-plan-viewer] Hook added to ${tildePath(allSettings[0])}`);
+        }
+        else {
+            // Multiple configs — prompt user
+            const selected = await promptMultiSelect(allSettings, 'Install hook in which configs?', process.env.CLAUDE_CONFIG_DIR);
+            if (selected.length === 0) {
+                console.log('[cc-plan-viewer] No configs selected. Hook not installed.');
+                return;
+            }
+            for (const idx of selected) {
+                addHookToSettings(allSettings[idx]);
+                console.log(`[cc-plan-viewer] Hook added to ${tildePath(allSettings[idx])}`);
+            }
+        }
     }
-    const hookCommand = getHookCommand();
-    // Remove any existing cc-plan-viewer hooks first (handles upgrades)
-    hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
-        if (typeof entry !== 'object' || entry === null)
-            return true;
-        const e = entry;
-        if (!Array.isArray(e.hooks))
-            return true;
-        return !e.hooks.some((h) => {
-            if (typeof h !== 'object' || h === null)
-                return false;
-            const cmd = h.command;
-            return typeof cmd === 'string' && cmd.includes('plan-viewer-hook');
-        });
-    });
-    // Add fresh hook entry
-    hooks.PostToolUse.push({
-        matcher: 'Write|Edit',
-        hooks: [{ type: 'command', command: hookCommand }],
-    });
-    writeSettings(settingsPath, settings);
+    console.log('');
     console.log('[cc-plan-viewer] Hook installed successfully.');
     console.log('');
     console.log('  Next time Claude Code writes a plan, the viewer will open in your browser.');
     console.log('');
     console.log('  Update anytime:   npx cc-plan-viewer@latest update');
     console.log('  Uninstall:        npx cc-plan-viewer uninstall');
-    if (settingsPath !== DEFAULT_SETTINGS) {
-        console.log(`  Custom config:    ${settingsPath}`);
-    }
 }
 function patchHookPaths() {
     // The installed hook is at ~/.cc-plan-viewer/plan-viewer-hook.cjs
@@ -197,30 +315,32 @@ function update() {
     }
     console.log('[cc-plan-viewer] Files updated in ~/.cc-plan-viewer/');
 }
-function uninstall() {
-    const settingsPath = resolveSettingsPath();
+async function uninstall() {
     console.log('[cc-plan-viewer] Uninstalling...');
-    // Remove hook from settings
-    const settings = readSettings(settingsPath);
-    const hooks = settings.hooks;
-    if (hooks?.PostToolUse && Array.isArray(hooks.PostToolUse)) {
-        const before = hooks.PostToolUse.length;
-        hooks.PostToolUse = hooks.PostToolUse.filter((entry) => {
-            if (typeof entry !== 'object' || entry === null)
-                return true;
-            const e = entry;
-            if (!Array.isArray(e.hooks))
-                return true;
-            return !e.hooks.some((h) => {
-                if (typeof h !== 'object' || h === null)
-                    return false;
-                const cmd = h.command;
-                return typeof cmd === 'string' && cmd.includes('plan-viewer-hook');
-            });
-        });
-        if (hooks.PostToolUse.length < before) {
-            writeSettings(settingsPath, settings);
-            console.log(`[cc-plan-viewer] Hook removed from ${settingsPath}`);
+    // Determine which settings files to clean up
+    const configIdx = process.argv.indexOf('--config');
+    if (configIdx !== -1 && process.argv[configIdx + 1]) {
+        const settingsPath = path.resolve(process.argv[configIdx + 1]);
+        if (removeHookFromSettings(settingsPath)) {
+            console.log(`[cc-plan-viewer] Hook removed from ${tildePath(settingsPath)}`);
+        }
+    }
+    else {
+        const allSettings = findAllClaudeSettings();
+        const withHook = allSettings.filter(settingsHasHook);
+        if (withHook.length === 0) {
+            console.log('[cc-plan-viewer] No hooks found in any Claude config.');
+        }
+        else if (withHook.length === 1) {
+            removeHookFromSettings(withHook[0]);
+            console.log(`[cc-plan-viewer] Hook removed from ${tildePath(withHook[0])}`);
+        }
+        else {
+            const selected = await promptMultiSelect(withHook, 'Remove hook from which configs?');
+            for (const idx of selected) {
+                removeHookFromSettings(withHook[idx]);
+                console.log(`[cc-plan-viewer] Hook removed from ${tildePath(withHook[idx])}`);
+            }
         }
     }
     // Remove installed files
@@ -266,13 +386,13 @@ function version() {
 const command = process.argv[2];
 switch (command) {
     case 'install':
-        install();
+        await install();
         break;
     case 'update':
         update();
         break;
     case 'uninstall':
-        uninstall();
+        await uninstall();
         break;
     case 'start':
         start();
@@ -288,11 +408,14 @@ switch (command) {
 cc-plan-viewer — Browser-based review UI for Claude Code plans
 
 Usage:
-  npx cc-plan-viewer install              Install hook + viewer files
-  npx cc-plan-viewer install --config <path>  Use custom settings.json path
-  npx cc-plan-viewer@latest update        Update to latest version
-  npx cc-plan-viewer uninstall            Remove hook + viewer files
-  npx cc-plan-viewer version              Show installed version
+  npx cc-plan-viewer install                  Install hook + viewer files
+  npx cc-plan-viewer install --config <path>  Use specific settings.json path
+  npx cc-plan-viewer@latest update            Update to latest version
+  npx cc-plan-viewer uninstall                Remove hook + viewer files
+  npx cc-plan-viewer version                  Show installed version
+
+When multiple Claude configs are detected (~/.claude*/settings.json),
+you'll be prompted to choose which ones to install the hook in.
 
 Files are installed to ~/.cc-plan-viewer/ so they persist across npm cache clears.
 `);

package/dist/server/server/app.js

@@ -6,7 +6,8 @@ import path from 'node:path';
 import { parsePlan } from './planParser.js';
 import { saveReview, getReview } from './reviewStore.js';
 import { resetIdleTimer } from './lifecycle.js';
-export function createApp(plansDirs) {
+export function createApp(initialPlansDirs) {
+    const plansDirs = [...initialPlansDirs];
     const plansDir = plansDirs[0] || '';
     const app = express();
     const server = createServer(app);
@@ -86,6 +87,11 @@ export function createApp(plansDirs) {
     app.post('/api/plan-updated', (req, res) => {
         const { filePath, planOptions } = req.body;
         const filename = path.basename(filePath || '');
+        // Dynamically register new plan directories (e.g., project-level .claude/plans/)
+        const dir = path.dirname(filePath || '');
+        if (dir && !plansDirs.includes(dir) && fs.existsSync(dir)) {
+            plansDirs.push(dir);
+        }
         // Broadcast to all WebSocket clients
         const message = JSON.stringify({
             type: 'plan-updated',

package/dist/server-bundle.mjs

@@ -27481,7 +27481,8 @@ function resetIdleTimer() {
 }
 
 // dist/server/server/app.js
-function createApp(plansDirs2) {
+function createApp(initialPlansDirs) {
+  const plansDirs2 = [...initialPlansDirs];
   const plansDir = plansDirs2[0] || "";
   const app = (0, import_express.default)();
   const server2 = createServer(app);
@@ -27552,6 +27553,10 @@ function createApp(plansDirs2) {
   app.post("/api/plan-updated", (req, res) => {
     const { filePath, planOptions } = req.body;
     const filename = path3.basename(filePath || "");
+    const dir = path3.dirname(filePath || "");
+    if (dir && !plansDirs2.includes(dir) && fs3.existsSync(dir)) {
+      plansDirs2.push(dir);
+    }
     const message = JSON.stringify({
       type: "plan-updated",
       filename,

package/hooks/plan-viewer-hook.cjs

@@ -14,17 +14,21 @@ const PORT_FILE = path.join(os.tmpdir(), 'cc-plan-viewer-port');
 const DEBOUNCE_FILE = path.join(os.tmpdir(), 'cc-plan-viewer-opened.json');
 const DEBOUNCE_MS = 5000; // 5 seconds (prevents rapid re-opens during multi-chunk writes)
 
-// Dynamically find all ~/.claude*/plans/ directories
+// Dynamically find all plans directories (home-level + project-level)
 function getAllPlansDirs() {
+  const dirs = [];
   const home = os.homedir();
   try {
-    return fs.readdirSync(home)
+    fs.readdirSync(home)
       .filter(name => name.startsWith('.claude'))
       .map(name => path.join(home, name, 'plans'))
-      .filter(dir => fs.existsSync(dir));
-  } catch {
-    return [];
-  }
+      .filter(dir => fs.existsSync(dir))
+      .forEach(dir => dirs.push(dir));
+  } catch {}
+  // Project-level: {cwd}/.claude/plans/
+  const projectDir = path.join(process.cwd(), '.claude', 'plans');
+  if (fs.existsSync(projectDir)) dirs.push(projectDir);
+  return dirs;
 }
 
 function getServerPort() {
@@ -37,10 +41,12 @@ function getServerPort() {
 
 function isPlanFile(filePath) {
   if (!filePath || !filePath.endsWith('.md')) return false;
-  // Match any ~/.claude*/plans/*.md
+  // Home-level: ~/.claude*/plans/*.md
   const home = os.homedir();
   const rel = path.relative(home, filePath);
-  return /^\.claude[^/]*\/plans\/[^/]+\.md$/.test(rel);
+  if (/^\.claude[^/]*\/plans\/[^/]+\.md$/.test(rel)) return true;
+  // Project-level: */.claude/plans/*.md
+  return /\/\.claude\/plans\/[^/]+\.md$/.test(filePath);
 }
 
 function shouldOpenBrowser(filename) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-plan-viewer",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Browser-based PR-style review UI for Claude Code plans",
   "type": "module",
   "bin": {