analyzthis_design 2.3.0 → 2.3.1

package/README.md

@@ -4,6 +4,22 @@ A set of AI design personas and a task-first evaluation framework that plugs int
 
 Install once. Run structured UX critiques, multi-phase ideation, and task-grounded screen reviews — directly inside your AI chat. **No external LLM API keys required** for CLI orchestrator runs: **`/devi`** voices each persona from your host IDE (Cursor, Claude, etc.).
 
+## v2.3.1 — independently callable personas (31 Aug 2026)
+
+After install, type `/noor`, `/anuj`, `/arjun`, `/meera`, `/priya`, `/zara`, `/raj`, `/kavi` even if Claude’s slash menu only lists Getting Started.
+
+- `npx analyzthis_design --target claude` is the same as `install --target claude` (leading `--target` used to print “Unknown command”).
+- Install writes project slash commands into `.claude/commands/` and `.cursor/commands/`.
+- `mcp --configure claude` writes Claude Desktop, Claude Code (`~/.claude.json`), and this repo’s `.mcp.json` when you are in a project.
+- Do not `npm install` this package inside a pnpm/Yarn `workspace:*` repo — use `npx … --target` instead.
+- Slash and MCP still use the model already in your chat. CLI `run` still picks a strong planner and cheap chunks.
+
+Website changelog: [analyzthis-lab.vercel.app/design#whats-new](https://analyzthis-lab.vercel.app/design#whats-new)
+
+## v2.3.0 — MCP for any IDE
+
+19 MCP tools (`analyzthis_noor`, not `/noor`). Slash commands and MCP are different pipes. MCP never creates a slash menu entry.
+
 ## v2.2 — project-scoped knowledge bank
 
 Knowledge sources are now scoped per project by default. `collect`, `connect`, `sync`, `disconnect`, and `status` operate on the project derived from your current working directory, and the built `knowledge-bank` skill is written into that project's local skills directory (`<project>/.claude/skills/knowledge-bank/SKILL.md`, `<project>/.cursor/skills/...`, etc.). Invoking a skill from one project never reads another project's vaults.
@@ -21,17 +37,21 @@ Pass `--global` to opt into the legacy merged behavior (read `config.sources` an
 
 Use `npx analyzthis_design run-unchunked` for the legacy single-pass orchestrator.
 
-**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.3.0 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
+**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.3.1 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
 
 ---
 
 ## Quick start
 
 ```bash
-# 1. Install the npm package (no auto-install, no obfuscation)
+# 1. Install the CLI globally (optional). Do not run npm install inside a
+#    pnpm/Yarn workspace repo — npm cannot read workspace:* and will fail.
+#    Prefer npx from any folder:
 npm install -g analyzthis_design
 
-# 2. Install slash commands into your IDE (explicit, consent-based)
+# 2. Copy skills + slash commands into your IDE (consent-based)
+npx analyzthis_design install --target all
+# Same thing: a leading --target means install
 npx analyzthis_design --target all
 
 # 3. Run a task in v2.0 chunked mode (free/cheap models)
@@ -41,13 +61,14 @@ npx analyzthis_design run --task "Review invoice approval screen"
 npx analyzthis_design run-unchunked --task "Review invoice approval screen" --provider host
 ```
 
-> **Security:** This package publishes **plain source** — no obfuscation, no minification, no dynamic require. Every file in `dist/` is readable and auditable. The `postinstall` script only prints a welcome message; it does **not** write to any AI-agent directories. Skill installation requires an explicit `npx analyzthis_design --target <ide>` command.
+> **Security:** This package publishes **plain source** — no obfuscation, no minification, no dynamic require. Every file in `dist/` is readable and auditable. The `postinstall` script only prints a welcome message; it does **not** write to any AI-agent directories. Skill installation requires an explicit `npx analyzthis_design install --target <ide>` (or `npx analyzthis_design --target <ide>`).
 >
-> **MCP (universal):** `npx analyzthis_design mcp` starts a local MCP server with 19 tools (all personas + combination passes + utilities). Auto-configures for Cursor, Claude Desktop, and Windsurf during `--target all` install. For Lovable, v0, Bolt, Replit, ChatGPT: run `npx analyzthis_design mcp --configure <tool>` for a config snippet.
+> **MCP (universal):** `npx analyzthis_design mcp` starts a local MCP server with 19 tools (all personas + combination passes + utilities). Auto-configures for Cursor, Claude Desktop, **Claude Code**, and Windsurf during install. For Lovable, v0, Bolt, Replit, ChatGPT: run `npx analyzthis_design mcp --configure <tool>` for a config snippet.
 
 ### Install by target IDE
 
 ```bash
+npx analyzthis_design install --target claude
 npx analyzthis_design --target claude
 npx analyzthis_design --target codex
 npx analyzthis_design --target grok
@@ -55,7 +76,7 @@ npx analyzthis_design --target windsurf
 npx analyzthis_design --target all --force
 ```
 
-**After install:** type `/getting-started` in Cursor or Claude Code (or `@getting-started` in Windsurf). For a complete walkthrough, see [HOW-TO-USE.md](./HOW-TO-USE.md). Re-print CLI help anytime with `npx analyzthis_design welcome`.
+**After install:** type `/noor`, `/arjun`, `/ux-ideator` (or `@` in Windsurf). Claude’s menu may only show Getting Started — type the name anyway. Also `/getting-started`. Walkthrough: [HOW-TO-USE.md](./HOW-TO-USE.md). Re-print help: `npx analyzthis_design welcome`.
 
 | Tool | Skills installed to | Invoke |
 |---|---|---|

package/dist/README.md

@@ -4,6 +4,22 @@ A set of AI design personas and a task-first evaluation framework that plugs int
 
 Install once. Run structured UX critiques, multi-phase ideation, and task-grounded screen reviews — directly inside your AI chat. **No external LLM API keys required** for CLI orchestrator runs: **`/devi`** voices each persona from your host IDE (Cursor, Claude, etc.).
 
+## v2.3.1 — independently callable personas (31 Aug 2026)
+
+After install, type `/noor`, `/anuj`, `/arjun`, `/meera`, `/priya`, `/zara`, `/raj`, `/kavi` even if Claude’s slash menu only lists Getting Started.
+
+- `npx analyzthis_design --target claude` is the same as `install --target claude` (leading `--target` used to print “Unknown command”).
+- Install writes project slash commands into `.claude/commands/` and `.cursor/commands/`.
+- `mcp --configure claude` writes Claude Desktop, Claude Code (`~/.claude.json`), and this repo’s `.mcp.json` when you are in a project.
+- Do not `npm install` this package inside a pnpm/Yarn `workspace:*` repo — use `npx … --target` instead.
+- Slash and MCP still use the model already in your chat. CLI `run` still picks a strong planner and cheap chunks.
+
+Website changelog: [analyzthis-lab.vercel.app/design#whats-new](https://analyzthis-lab.vercel.app/design#whats-new)
+
+## v2.3.0 — MCP for any IDE
+
+19 MCP tools (`analyzthis_noor`, not `/noor`). Slash commands and MCP are different pipes. MCP never creates a slash menu entry.
+
 ## v2.2 — project-scoped knowledge bank
 
 Knowledge sources are now scoped per project by default. `collect`, `connect`, `sync`, `disconnect`, and `status` operate on the project derived from your current working directory, and the built `knowledge-bank` skill is written into that project's local skills directory (`<project>/.claude/skills/knowledge-bank/SKILL.md`, `<project>/.cursor/skills/...`, etc.). Invoking a skill from one project never reads another project's vaults.
@@ -21,17 +37,21 @@ Pass `--global` to opt into the legacy merged behavior (read `config.sources` an
 
 Use `npx analyzthis_design run-unchunked` for the legacy single-pass orchestrator.
 
-**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.3.0 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
+**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.3.1 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
 
 ---
 
 ## Quick start
 
 ```bash
-# 1. Install the npm package (no auto-install, no obfuscation)
+# 1. Install the CLI globally (optional). Do not run npm install inside a
+#    pnpm/Yarn workspace repo — npm cannot read workspace:* and will fail.
+#    Prefer npx from any folder:
 npm install -g analyzthis_design
 
-# 2. Install slash commands into your IDE (explicit, consent-based)
+# 2. Copy skills + slash commands into your IDE (consent-based)
+npx analyzthis_design install --target all
+# Same thing: a leading --target means install
 npx analyzthis_design --target all
 
 # 3. Run a task in v2.0 chunked mode (free/cheap models)
@@ -41,13 +61,14 @@ npx analyzthis_design run --task "Review invoice approval screen"
 npx analyzthis_design run-unchunked --task "Review invoice approval screen" --provider host
 ```
 
-> **Security:** This package publishes **plain source** — no obfuscation, no minification, no dynamic require. Every file in `dist/` is readable and auditable. The `postinstall` script only prints a welcome message; it does **not** write to any AI-agent directories. Skill installation requires an explicit `npx analyzthis_design --target <ide>` command.
+> **Security:** This package publishes **plain source** — no obfuscation, no minification, no dynamic require. Every file in `dist/` is readable and auditable. The `postinstall` script only prints a welcome message; it does **not** write to any AI-agent directories. Skill installation requires an explicit `npx analyzthis_design install --target <ide>` (or `npx analyzthis_design --target <ide>`).
 >
-> **MCP (universal):** `npx analyzthis_design mcp` starts a local MCP server with 19 tools (all personas + combination passes + utilities). Auto-configures for Cursor, Claude Desktop, and Windsurf during `--target all` install. For Lovable, v0, Bolt, Replit, ChatGPT: run `npx analyzthis_design mcp --configure <tool>` for a config snippet.
+> **MCP (universal):** `npx analyzthis_design mcp` starts a local MCP server with 19 tools (all personas + combination passes + utilities). Auto-configures for Cursor, Claude Desktop, **Claude Code**, and Windsurf during install. For Lovable, v0, Bolt, Replit, ChatGPT: run `npx analyzthis_design mcp --configure <tool>` for a config snippet.
 
 ### Install by target IDE
 
 ```bash
+npx analyzthis_design install --target claude
 npx analyzthis_design --target claude
 npx analyzthis_design --target codex
 npx analyzthis_design --target grok
@@ -55,7 +76,7 @@ npx analyzthis_design --target windsurf
 npx analyzthis_design --target all --force
 ```
 
-**After install:** type `/getting-started` in Cursor or Claude Code (or `@getting-started` in Windsurf). For a complete walkthrough, see [HOW-TO-USE.md](./HOW-TO-USE.md). Re-print CLI help anytime with `npx analyzthis_design welcome`.
+**After install:** type `/noor`, `/arjun`, `/ux-ideator` (or `@` in Windsurf). Claude’s menu may only show Getting Started — type the name anyway. Also `/getting-started`. Walkthrough: [HOW-TO-USE.md](./HOW-TO-USE.md). Re-print help: `npx analyzthis_design welcome`.
 
 | Tool | Skills installed to | Invoke |
 |---|---|---|

package/dist/bin/cli.js

@@ -248,7 +248,13 @@ Docs: https://github.com/rishikeshjoshi/analyzthis_design
 
 // ─── Parse args ──────────────────────────────────────────────────────────────
 
-const [,, cmd, ...flags] = process.argv;
+let [, , cmd, ...flags] = process.argv;
+// Leading flags mean install: `npx analyzthis_design --target claude`
+// Keep --help / -h as help, not install.
+if (cmd && cmd.startsWith('-') && cmd !== '--help' && cmd !== '-h') {
+  flags = [cmd, ...flags];
+  cmd = 'install';
+}
 
 function getFlag(name) {
   // Supports both --flag=value and --flag value

package/dist/lib/install.js

@@ -17,6 +17,24 @@ const PACKAGE_ROOT = resolvePackageRoot(__dirname);
 const PACKAGE_SKILLS_DIR = path.join(PACKAGE_ROOT, 'skills');
 const WELCOME_MARKER = path.join(os.homedir(), '.analyzthis_design', '.welcome-shown');
 
+// Slash items written into the current project so /noor shows in the menu.
+const PROJECT_COMMANDS = [
+  'noor',
+  'anuj',
+  'arjun',
+  'meera',
+  'priya',
+  'zara',
+  'raj',
+  'kavi',
+  'ux-ideator',
+  'design-director',
+  'persona-orchestrator',
+  'design-critic',
+  'getting-started',
+  'devi',
+];
+
 const SKILLS = [
   'getting-started',
   'arjun',
@@ -88,6 +106,13 @@ function printWelcomeBanner(targetId, log = console.log) {
     log(`  ${gs}          ← read this first`);
   }
 
+  log('');
+  log('  Independent personas — type the name (even if the menu only shows Getting Started):');
+  log(`    ${p}noor  ${p}anuj  ${p}arjun  ${p}meera  ${p}priya  ${p}zara  ${p}raj  ${p}kavi`);
+  if (targetId === 'claude') {
+    log('    Claude may only list Getting Started. Type /noor anyway.');
+  }
+
   log('');
   log('  Design — wireframes (new screens):');
   log(`    ${p}ux-ideator               two competing text wireframes + deliberation`);
@@ -180,6 +205,29 @@ function installMissing(skill, destinations, force) {
   return status;
 }
 
+function installProjectCommands({ force = false, log = console.log } = {}) {
+  const cwd = process.cwd();
+  const roots = [
+    path.join(cwd, '.claude', 'commands'),
+    path.join(cwd, '.cursor', 'commands'),
+  ];
+  const installed = [];
+  const skipped = [];
+  for (const root of roots) {
+    for (const skill of PROJECT_COMMANDS) {
+      const result = installFlat(skill, root, force);
+      if (result === 'installed') installed.push(`${path.relative(cwd, root)}/${skill}.md`);
+      else if (result === 'skipped') skipped.push(skill);
+    }
+  }
+  if (installed.length > 0) {
+    log(`\n✅ Project slash commands → ${path.join(cwd, '.claude/commands')} and .cursor/commands`);
+    log('   Type /noor /arjun /ux-ideator in this repo. Restart the IDE if the menu is stale.');
+  } else if (skipped.length > 0) {
+    log(`\n⏭  Project slash commands already present (use --force to overwrite).`);
+  }
+}
+
 function install({ silent = false, force = false, target = 'cursor', showBanner = true } = {}) {
   const log = silent ? () => {} : console.log;
   const warn = silent ? () => {} : console.warn;
@@ -239,6 +287,8 @@ function install({ silent = false, force = false, target = 'cursor', showBanner
       }
     }
   }
+
+  installProjectCommands({ force, log });
 }
 
 function remove({ silent = false, target = 'cursor' } = {}) {
@@ -287,6 +337,7 @@ module.exports = {
   install,
   remove,
   SKILLS,
+  PROJECT_COMMANDS,
   TARGET_DIRS,
   TARGETS,
   ALL_TARGET_IDS,

package/dist/lib/mcp-server.js

@@ -520,70 +520,68 @@ function readSkill(id) {
 
 // ── MCP config writer ──
 
+function mergeMcpServer(configPath) {
+  var dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  var config = {};
+  if (fs.existsSync(configPath)) {
+    try { config = JSON.parse(fs.readFileSync(configPath, 'utf8')); } catch (e) {}
+  }
+  if (typeof config !== 'object' || config === null || Array.isArray(config)) config = {};
+  config.mcpServers = config.mcpServers || {};
+  config.mcpServers['analyzthis_design'] = {
+    command: 'npx',
+    args: ['analyzthis_design', 'mcp'],
+  };
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  return configPath;
+}
+
+function looksLikeProjectCwd() {
+  var cwd = process.cwd();
+  return fs.existsSync(path.join(cwd, 'package.json')) || fs.existsSync(path.join(cwd, '.git'));
+}
+
 function writeMcpConfig(target) {
-  var serverCmd = 'npx';
-  var serverArgs = ['analyzthis_design', 'mcp'];
   var home = os.homedir();
 
   if (target === 'cursor') {
     var cursorConfigPath = path.join(home, '.cursor', 'mcp.json');
-    var cursorDir = path.dirname(cursorConfigPath);
-    if (!fs.existsSync(cursorDir)) fs.mkdirSync(cursorDir, { recursive: true });
-    var cursorConfig = {};
-    if (fs.existsSync(cursorConfigPath)) {
-      try { cursorConfig = JSON.parse(fs.readFileSync(cursorConfigPath, 'utf8')); } catch (e) {}
-    }
-    cursorConfig.mcpServers = cursorConfig.mcpServers || {};
-    cursorConfig.mcpServers['analyzthis_design'] = {
-      command: serverCmd,
-      args: serverArgs,
-    };
-    fs.writeFileSync(cursorConfigPath, JSON.stringify(cursorConfig, null, 2));
+    mergeMcpServer(cursorConfigPath);
     console.log('Cursor MCP config written to ' + cursorConfigPath);
     console.log('Restart Cursor to activate.\n');
     return true;
   }
 
   if (target === 'claude') {
-    var claudeConfigPath;
+    var claudeDesktopPath;
     if (process.platform === 'darwin') {
-      claudeConfigPath = path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+      claudeDesktopPath = path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
     } else if (process.platform === 'win32') {
-      claudeConfigPath = path.join(home, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json');
+      claudeDesktopPath = path.join(home, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json');
     } else {
-      claudeConfigPath = path.join(home, '.config', 'Claude', 'claude_desktop_config.json');
+      claudeDesktopPath = path.join(home, '.config', 'Claude', 'claude_desktop_config.json');
     }
-    var claudeDir = path.dirname(claudeConfigPath);
-    if (!fs.existsSync(claudeDir)) fs.mkdirSync(claudeDir, { recursive: true });
-    var claudeConfig = {};
-    if (fs.existsSync(claudeConfigPath)) {
-      try { claudeConfig = JSON.parse(fs.readFileSync(claudeConfigPath, 'utf8')); } catch (e) {}
+    mergeMcpServer(claudeDesktopPath);
+    console.log('Claude Desktop MCP config written to ' + claudeDesktopPath);
+
+    var claudeCodePath = path.join(home, '.claude.json');
+    mergeMcpServer(claudeCodePath);
+    console.log('Claude Code MCP config written to ' + claudeCodePath);
+
+    if (looksLikeProjectCwd()) {
+      var projectMcp = path.join(process.cwd(), '.mcp.json');
+      mergeMcpServer(projectMcp);
+      console.log('Project MCP config written to ' + projectMcp);
     }
-    claudeConfig.mcpServers = claudeConfig.mcpServers || {};
-    claudeConfig.mcpServers['analyzthis_design'] = {
-      command: serverCmd,
-      args: serverArgs,
-    };
-    fs.writeFileSync(claudeConfigPath, JSON.stringify(claudeConfig, null, 2));
-    console.log('Claude Desktop MCP config written to ' + claudeConfigPath);
-    console.log('Restart Claude Desktop to activate.\n');
+
+    console.log('Restart Claude Code and Claude Desktop to activate.\n');
     return true;
   }
 
   if (target === 'windsurf') {
     var windsurfConfigPath = path.join(home, '.codeium', 'windsurf', 'mcp_config.json');
-    var windsurfDir = path.dirname(windsurfConfigPath);
-    if (!fs.existsSync(windsurfDir)) fs.mkdirSync(windsurfDir, { recursive: true });
-    var windsurfConfig = {};
-    if (fs.existsSync(windsurfConfigPath)) {
-      try { windsurfConfig = JSON.parse(fs.readFileSync(windsurfConfigPath, 'utf8')); } catch (e) {}
-    }
-    windsurfConfig.mcpServers = windsurfConfig.mcpServers || {};
-    windsurfConfig.mcpServers['analyzthis_design'] = {
-      command: serverCmd,
-      args: serverArgs,
-    };
-    fs.writeFileSync(windsurfConfigPath, JSON.stringify(windsurfConfig, null, 2));
+    mergeMcpServer(windsurfConfigPath);
     console.log('Windsurf MCP config written to ' + windsurfConfigPath);
     console.log('Restart Windsurf to activate.\n');
     return true;
@@ -593,8 +591,8 @@ function writeMcpConfig(target) {
   console.log(JSON.stringify({
     mcpServers: {
       'analyzthis_design': {
-        command: serverCmd,
-        args: serverArgs,
+        command: 'npx',
+        args: ['analyzthis_design', 'mcp'],
       }
     }
   }, null, 2));