@acmeacmeio/setup-sh 0.2.6 → 0.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acmeacmeio/setup-sh",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Bootstrap a multi-agent workspace (Claude Code, Codex, Cursor) with team standards, hooks, and skills",
   "author": "ACMEACMEIO",
   "license": "MIT",

package/src/cli.mjs

@@ -110,6 +110,23 @@ function exec(cmd, options = {}) {
 // ============================================================================
 // Interactive Prompts
 // ============================================================================
+function renderMultiSelect(question, options, cursor, selected) {
+  const lines = [`\n${question} ${colors.dim}(space=toggle, enter=confirm)${colors.reset}`];
+  for (let i = 0; i < options.length; i++) {
+    const isSelected = selected.has(i);
+    const isCursor = i === cursor;
+    const pointer = isCursor ? `${colors.cyan}>${colors.reset}` : " ";
+    const checkbox = isSelected
+      ? `${colors.green}[x]${colors.reset}`
+      : `${colors.dim}[ ]${colors.reset}`;
+    const label = isCursor
+      ? `${colors.bold}${options[i].label}${colors.reset}`
+      : options[i].label;
+    lines.push(`  ${pointer} ${checkbox} ${label}`);
+  }
+  return lines.join("\n");
+}
+
 function createPrompt(autoYes = false) {
   const rl = createInterface({
     input: process.stdin,
@@ -133,23 +150,134 @@ function createPrompt(autoYes = false) {
       if (answer === "") return defaultYes;
       return answer.toLowerCase() === "y";
     },
-    select: async (question, options) => {
-      console.log(`\n${question}`);
-      options.forEach((opt, i) => {
-        console.log(
-          `  ${colors.cyan}${i + 1}${colors.reset}) ${opt.label}${opt.default ? ` ${colors.dim}(default)${colors.reset}` : ""}`,
+    /**
+     * Interactive multi-select with arrow keys.
+     * Returns an array of selected values.
+     */
+    multiSelect: (question, options) =>
+      new Promise((resolve) => {
+        // Pause readline so we can use raw mode
+        rl.pause();
+
+        let cursor = 0;
+        const selected = new Set(
+          options
+            .map((opt, i) => (opt.default ? i : -1))
+            .filter((i) => i >= 0),
         );
-      });
-      const answer = await new Promise((resolve) => {
-        rl.question(`\nSelect [1-${options.length}]: `, resolve);
-      });
-      const idx = parseInt(answer, 10) - 1;
-      if (isNaN(idx) || idx < 0 || idx >= options.length) {
-        const defaultOpt = options.find((o) => o.default);
-        return defaultOpt ? defaultOpt.value : options[0].value;
-      }
-      return options[idx].value;
-    },
+
+        // Render initial state
+        let output = renderMultiSelect(question, options, cursor, selected);
+        process.stdout.write(output);
+
+        const stdin = process.stdin;
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding("utf8");
+
+        // Line count minus 1 = how many lines to move up from the last line
+        const linesToMoveUp = output.split("\n").length - 1;
+
+        function redraw() {
+          // Move cursor up to the start, then clear to end of screen
+          process.stdout.write(`\x1b[${linesToMoveUp}A\x1b[0J`);
+          output = renderMultiSelect(question, options, cursor, selected);
+          process.stdout.write(output);
+        }
+
+        function cleanup() {
+          stdin.setRawMode(false);
+          stdin.removeListener("data", onKey);
+          rl.resume();
+        }
+
+        // Buffer for multi-byte escape sequences (e.g. arrow keys: \x1b [ A)
+        let escBuf = "";
+
+        function onKey(chunk) {
+          for (const ch of chunk) {
+            // If we're accumulating an escape sequence
+            if (escBuf.length > 0) {
+              escBuf += ch;
+              // Second byte must be '['
+              if (escBuf.length === 2 && ch !== "[") {
+                escBuf = "";
+                continue;
+              }
+              // Third byte completes the sequence
+              if (escBuf.length === 3) {
+                const seq = escBuf;
+                escBuf = "";
+                if (seq === "\x1b[A") {
+                  cursor = (cursor - 1 + options.length) % options.length;
+                  redraw();
+                } else if (seq === "\x1b[B") {
+                  cursor = (cursor + 1) % options.length;
+                  redraw();
+                }
+              }
+              continue;
+            }
+
+            // Start of escape sequence
+            if (ch === "\x1b") {
+              escBuf = ch;
+              continue;
+            }
+
+            // Ctrl+C
+            if (ch === "\x03") {
+              cleanup();
+              process.exit(0);
+            }
+
+            // Enter
+            if (ch === "\r" || ch === "\n") {
+              cleanup();
+              redraw();
+              process.stdout.write("\n");
+              const values = [...selected].map((i) => options[i].value);
+              resolve(values.length > 0 ? values : [options[0].value]);
+              return;
+            }
+
+            // Space - toggle
+            if (ch === " ") {
+              if (selected.has(cursor)) {
+                selected.delete(cursor);
+              } else {
+                selected.add(cursor);
+              }
+              redraw();
+              continue;
+            }
+
+            // vim-style navigation
+            if (ch === "k") {
+              cursor = (cursor - 1 + options.length) % options.length;
+              redraw();
+              continue;
+            }
+            if (ch === "j") {
+              cursor = (cursor + 1) % options.length;
+              redraw();
+              continue;
+            }
+
+            // 'a' to toggle all
+            if (ch === "a") {
+              if (selected.size === options.length) {
+                selected.clear();
+              } else {
+                for (let i = 0; i < options.length; i++) selected.add(i);
+              }
+              redraw();
+            }
+          }
+        }
+
+        stdin.on("data", onKey);
+      }),
     close: () => rl.close(),
   };
 }
@@ -192,37 +320,15 @@ const TOOLS = {
       windows: "npm install -g pnpm",
     },
   },
-  python: {
-    name: "Python 3.11+",
-    check: () => commandExists("python3.11") || commandExists("python3"),
-    install: {
-      macos: "brew install python@3.11",
-      debian: "sudo apt install -y python3.11 python3.11-venv",
-      fedora: "sudo dnf install -y python3.11",
-      arch: "sudo pacman -S --noconfirm python",
-      windows: "winget install Python.Python.3.11",
-    },
-  },
-  uv: {
-    name: "uv (Python package manager)",
-    check: () => commandExists("uv"),
-    install: {
-      macos: "curl -LsSf https://astral.sh/uv/install.sh | sh",
-      debian: "curl -LsSf https://astral.sh/uv/install.sh | sh",
-      fedora: "curl -LsSf https://astral.sh/uv/install.sh | sh",
-      arch: "curl -LsSf https://astral.sh/uv/install.sh | sh",
-      windows: 'powershell -c "irm https://astral.sh/uv/install.ps1 | iex"',
-    },
-  },
-  "browser-use": {
-    name: "browser-use (Browser automation)",
-    check: () => commandExists("browser-use"),
+  "agent-browser": {
+    name: "agent-browser (Browser automation)",
+    check: () => commandExists("agent-browser"),
     install: {
-      macos: "uv tool install browser-use && uvx browser-use install",
-      debian: "uv tool install browser-use && uvx browser-use install",
-      fedora: "uv tool install browser-use && uvx browser-use install",
-      arch: "uv tool install browser-use && uvx browser-use install",
-      windows: "uv tool install browser-use && uvx browser-use install",
+      macos: "npm install -g agent-browser && agent-browser install",
+      debian: "npm install -g agent-browser && agent-browser install --with-deps",
+      fedora: "npm install -g agent-browser && agent-browser install --with-deps",
+      arch: "npm install -g agent-browser && agent-browser install --with-deps",
+      windows: "npm install -g agent-browser && agent-browser install",
     },
   },
 };
@@ -282,24 +388,26 @@ const SKILL_SOURCES = [
   // Official Anthropic skills
   { repo: "anthropics/anthropic-skills", skills: ["frontend-design"] },
   // Browser automation
-  { repo: "browser-use/browser-use", skills: ["browser-use"] },
+  { repo: "vercel-labs/agent-browser", skills: ["agent-browser"], cmd: "npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser" },
+  // Skill discovery
+  { repo: "vercel-labs/skills", skills: ["find-skills"], cmd: "npx skills add https://github.com/vercel-labs/skills --skill find-skills" },
   // TDD workflow
   { repo: "obra/superpowers", skills: ["test-driven-development"] },
+  // Vercel React best practices
+  { repo: "vercel-labs/agent-skills", skills: ["vercel-react-best-practices"], cmd: "npx skills add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practices" },
+  // Next.js best practices
+  { repo: "vercel-labs/next-skills", skills: ["next-best-practices"], cmd: "npx skills add https://github.com/vercel-labs/next-skills --skill next-best-practices" },
   // Supabase Postgres
   { repo: "supabase/agent-skills", skills: ["supabase-postgres-best-practices"] },
 ];
 
 async function installSkills(prompt, agentChoice) {
-  // Skills installation only applies to Claude Code
-  // Codex uses the bundled skills from .codex/skills/
-  // Cursor uses MDC rules bundled in .cursor/rules/
-  if (agentChoice === "codex") {
-    log.info("Codex skills are bundled in .codex/skills/ directory");
-    return;
-  }
+  const agents = normalizeAgents(agentChoice);
 
-  if (agentChoice === "cursor") {
-    log.info("Cursor rules are bundled in .cursor/rules/ directory");
+  // Skills installation only applies to Claude Code
+  if (!agents.has("claude")) {
+    if (agents.has("codex")) log.info("Codex skills are bundled in .codex/skills/ directory");
+    if (agents.has("cursor")) log.info("Cursor rules are bundled in .cursor/rules/ directory");
     return;
   }
 
@@ -316,7 +424,8 @@ async function installSkills(prompt, agentChoice) {
     for (const skill of source.skills) {
       log.step(`Installing ${skill} from ${source.repo}...`);
       try {
-        exec(`npx add-skill ${source.repo} ${skill}`, {
+        const installCmd = source.cmd ?? `npx add-skill ${source.repo} ${skill}`;
+        exec(installCmd, {
           silent: true,
           ignoreError: true,
         });
@@ -331,12 +440,19 @@ async function installSkills(prompt, agentChoice) {
 // ============================================================================
 // Template Files
 // ============================================================================
+function normalizeAgents(agentChoice) {
+  if (Array.isArray(agentChoice)) return new Set(agentChoice);
+  if (agentChoice === "all") return new Set(["claude", "codex", "cursor"]);
+  return new Set([agentChoice]);
+}
+
 function copyTemplates(targetDir, agentChoice) {
   log.title("Setting Up Workspace");
 
-  const shouldCopyClaude = agentChoice === "claude" || agentChoice === "all";
-  const shouldCopyCodex = agentChoice === "codex" || agentChoice === "all";
-  const shouldCopyCursor = agentChoice === "cursor" || agentChoice === "all";
+  const agents = normalizeAgents(agentChoice);
+  const shouldCopyClaude = agents.has("claude");
+  const shouldCopyCodex = agents.has("codex");
+  const shouldCopyCursor = agents.has("cursor");
 
   // Copy Claude Code templates
   if (shouldCopyClaude) {
@@ -479,7 +595,7 @@ ${colors.bold}Usage:${colors.reset}
   npx @acmeacmeio/setup-sh [directory] [options]
 
 ${colors.bold}Options:${colors.reset}
-  --agent=<agent>  Select AI coding agent (claude, codex, cursor, all)
+  --agent=<agent>  Select AI coding agent(s) (claude, codex, cursor, all)
   -y, --yes        Auto-confirm all prompts
   -h, --help       Show this help message
 
@@ -532,20 +648,27 @@ ${colors.dim}Multi-Agent Workspace Initializer${colors.reset}
   const prompt = createPrompt(autoYes);
 
   try {
-    // Step 0: Select AI coding agent
-    let agentChoice = flags.agent;
-    if (!agentChoice) {
-      agentChoice = await prompt.select(
-        "Which AI coding agent are you using?",
+    // Step 0: Select AI coding agents
+    let agents;
+    if (flags.agent) {
+      agents = flags.agent === "all"
+        ? ["claude", "codex", "cursor"]
+        : [flags.agent];
+    } else if (autoYes) {
+      agents = ["claude"];
+      log.info("Auto-selecting: Claude Code (Anthropic)");
+    } else {
+      agents = await prompt.multiSelect(
+        "Which AI coding agents do you use?",
         [
           { value: "claude", label: "Claude Code (Anthropic)", default: true },
           { value: "codex", label: "Codex (OpenAI)" },
           { value: "cursor", label: "Cursor IDE" },
-          { value: "all", label: "All agents (generate all configs)" },
         ],
       );
     }
-    log.info(`Selected agent: ${agentChoice}`);
+    const agentChoice = agents.length === 3 ? "all" : agents.length === 1 ? agents[0] : agents;
+    log.info(`Selected: ${agents.join(", ")}`);
 
     // Step 1: Install system tools
     await installTools(platform, prompt);
@@ -577,38 +700,45 @@ ${getTips(agentChoice)}
 }
 
 function getNextSteps(agentChoice) {
-  const claudeSteps = `  - Review and customize ${colors.bold}CLAUDE.md${colors.reset} for your project
-  - Run ${colors.bold}claude${colors.reset} to start coding with AI assistance`;
-
-  const codexSteps = `  - Review and customize ${colors.bold}AGENTS.md${colors.reset} for your project
-  - Run ${colors.bold}codex${colors.reset} to start coding with AI assistance`;
+  const agents = normalizeAgents(agentChoice);
+  const steps = [];
 
-  const cursorSteps = `  - Review and customize ${colors.bold}CLAUDE.md${colors.reset} for your project (Cursor reads this)
-  - Add custom rules in ${colors.bold}.cursor/rules/${colors.reset}
-  - Open the project in Cursor IDE`;
+  if (agents.has("claude")) {
+    steps.push(`  - Review and customize ${colors.bold}CLAUDE.md${colors.reset} for your project`);
+    steps.push(`  - Run ${colors.bold}claude${colors.reset} to start coding with AI assistance`);
+  }
+  if (agents.has("codex")) {
+    steps.push(`  - Review and customize ${colors.bold}AGENTS.md${colors.reset} for your project`);
+    steps.push(`  - Run ${colors.bold}codex${colors.reset} to start coding with AI assistance`);
+  }
+  if (agents.has("cursor")) {
+    steps.push(`  - Review and customize ${colors.bold}CLAUDE.md${colors.reset} for your project (Cursor reads this)`);
+    steps.push(`  - Add custom rules in ${colors.bold}.cursor/rules/${colors.reset}`);
+    steps.push(`  - Open the project in Cursor IDE`);
+  }
 
-  if (agentChoice === "claude") return claudeSteps;
-  if (agentChoice === "codex") return codexSteps;
-  if (agentChoice === "cursor") return cursorSteps;
-  return claudeSteps + "\n" + codexSteps + "\n" + cursorSteps;
+  return steps.join("\n");
 }
 
 function getTips(agentChoice) {
-  const claudeTips = `  - Create ${colors.bold}CLAUDE.local.md${colors.reset} for personal preferences (gitignored)
-  - Edit ${colors.bold}.claude/settings.local.json${colors.reset} for local overrides`;
-
-  const codexTips = `  - Create ${colors.bold}AGENTS.local.md${colors.reset} for personal preferences (gitignored)
-  - Edit ${colors.bold}.codex/config.local.toml${colors.reset} for local overrides`;
+  const agents = normalizeAgents(agentChoice);
+  const tips = [];
 
-  const cursorTips = `  - Add ${colors.bold}alwaysApply: true${colors.reset} to rules that should always be active
-  - Use ${colors.bold}globs${colors.reset} in rules for file-specific context`;
-
-  const sharedTips = `  - Run ${colors.bold}gh auth login${colors.reset} if GitHub CLI needs authentication`;
+  if (agents.has("claude")) {
+    tips.push(`  - Create ${colors.bold}CLAUDE.local.md${colors.reset} for personal preferences (gitignored)`);
+    tips.push(`  - Edit ${colors.bold}.claude/settings.local.json${colors.reset} for local overrides`);
+  }
+  if (agents.has("codex")) {
+    tips.push(`  - Create ${colors.bold}AGENTS.local.md${colors.reset} for personal preferences (gitignored)`);
+    tips.push(`  - Edit ${colors.bold}.codex/config.local.toml${colors.reset} for local overrides`);
+  }
+  if (agents.has("cursor")) {
+    tips.push(`  - Add ${colors.bold}alwaysApply: true${colors.reset} to rules that should always be active`);
+    tips.push(`  - Use ${colors.bold}globs${colors.reset} in rules for file-specific context`);
+  }
 
-  if (agentChoice === "claude") return claudeTips + "\n" + sharedTips;
-  if (agentChoice === "codex") return codexTips + "\n" + sharedTips;
-  if (agentChoice === "cursor") return cursorTips + "\n" + sharedTips;
-  return claudeTips + "\n" + codexTips + "\n" + cursorTips + "\n" + sharedTips;
+  tips.push(`  - Run ${colors.bold}gh auth login${colors.reset} if GitHub CLI needs authentication`);
+  return tips.join("\n");
 }
 
 main();

package/templates/AGENTS.md

@@ -10,6 +10,8 @@ All new code follows Test-Driven Development:
 2. **Green**: Write minimal code to pass
 3. **Refactor**: Clean up while tests stay green
 
+**IMPORTANT: NEVER write implementation code before writing a failing test for it. The test file MUST exist and fail before any production code is written or modified. This is a hard requirement, not a guideline. If you are about to create or modify a source file, stop and write/update the test first.**
+
 TDD is enforced through the `test-driven-development` skill (installed from `obra/superpowers`). When writing new code, always use this skill to ensure proper Red-Green-Refactor workflow.
 
 ### TypeScript: Strict Mode
@@ -115,4 +117,4 @@ Use latest Next.js with App Router. Server Components by default, Client Compone
 - `$security-review` - Security audit checklist
 
 Note: Codex uses bundled skills from `.codex/skills/`. The following skills are available to Claude Code users via `npx add-skill`:
-- `test-driven-development`, `frontend-design`, `commit-commands`, `pr-review-toolkit`, `code-simplifier`, `browser-use`, `supabase-postgres-best-practices`
+- `test-driven-development`, `frontend-design`, `commit-commands`, `pr-review-toolkit`, `code-simplifier`, `agent-browser`, `find-skills`, `supabase-postgres-best-practices`

package/templates/CLAUDE.md

@@ -10,6 +10,8 @@ All new code follows Test-Driven Development:
 2. **Green**: Write minimal code to pass
 3. **Refactor**: Clean up while tests stay green
 
+**IMPORTANT: NEVER write implementation code before writing a failing test for it. The test file MUST exist and fail before any production code is written or modified. This is a hard requirement, not a guideline. If you are about to create or modify a source file, stop and write/update the test first.**
+
 TDD is enforced through the `test-driven-development` skill (installed from `obra/superpowers`). When writing new code, always use this skill to ensure proper Red-Green-Refactor workflow.
 
 ### TypeScript: Strict Mode
@@ -127,8 +129,11 @@ These are bundled extensions that provide subagents, skills, and commands as coh
 ### Installed Skills (via npx add-skill)
 - `test-driven-development` - TDD workflow enforcement (obra/superpowers)
 - `frontend-design` - Frontend design patterns (anthropics/anthropic-skills)
-- `browser-use` - Browser automation (browser-use/browser-use)
+- `agent-browser` - Browser automation (vercel-labs/agent-browser)
 - `supabase-postgres-best-practices` - Supabase/Postgres patterns (supabase/agent-skills)
+- `vercel-react-best-practices` - React/Next.js performance optimization (vercel-labs/agent-skills)
+- `next-best-practices` - Next.js best practices (vercel-labs/next-skills)
+- `find-skills` - Discover and install skills from the open agent skills ecosystem (vercel-labs/skills)
 
 ### Bundled Skills (in .claude/skills/)
 - `api-design` - REST + Zod API patterns