superpowers-mcp 6.3.2 → 6.3.4

package/out/setup-runner.js

@@ -0,0 +1,57 @@
+"use strict";var N=Object.create;var C=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var F=Object.getPrototypeOf,J=Object.prototype.hasOwnProperty;var H=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},A=(e,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of W(t))!J.call(e,n)&&n!==r&&C(e,n,{get:()=>t[n],enumerable:!(s=M(t,n))||s.enumerable});return e};var x=(e,t,r)=>(r=e!=null?N(F(e)):{},A(t||!e||!e.__esModule?C(r,"default",{value:e,enumerable:!0}):r,e)),T=e=>A(C({},"__esModule",{value:!0}),e);var K={};H(K,{HARNESS_CONFIGS:()=>j,isPlainObject:()=>b,runSetup:()=>O,runSetupCli:()=>L,safeWriteConfig:()=>I,stripJsonComments:()=>_,updateJsonConfig:()=>R,updateYamlConfig:()=>E});module.exports=T(K);var a=x(require("fs")),i=x(require("path")),P=x(require("os")),D=x(require("crypto")),j={copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(e,t,r,s)=>e==="win32"?i.join(r||i.join(t,"AppData","Roaming"),"Code","User","mcp.json"):e==="darwin"?i.join(t,"Library","Application Support","Code","User","mcp.json"):i.join(t,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(e,t)=>i.join(t,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(e,t,r,s)=>{if(e==="win32"){let n=s||i.join(t,"AppData","Local");return i.join(n,"hermes","config.yaml")}return i.join(t,".hermes","config.yaml")},type:"yaml",defaultConfig:(e,t)=>({command:e,args:t})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(e,t)=>i.join(t,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(e,t,r)=>e==="win32"?i.join(r||i.join(t,"AppData","Roaming"),"Claude","claude_desktop_config.json"):e==="darwin"?i.join(t,"Library","Application Support","Claude","claude_desktop_config.json"):i.join(t,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(e,t)=>{let r=i.join(t,".config","devin","mcp_config.json");return a.existsSync(r)?r:i.join(t,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(e,t)=>i.join(t,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(e,t,r)=>{if(e==="win32"){let p=i.join(r||i.join(t,"AppData","Roaming"),".pi","agent","mcp.json");if(a.existsSync(p))return p;let o=i.join(t,".pi","agent","mcp.json");if(a.existsSync(o))return o;let f=i.join(t,".pi","mcp.json");return a.existsSync(f)?f:o}let s=i.join(t,".pi","agent","mcp.json");if(a.existsSync(s))return s;let n=i.join(t,".pi","mcp.json");return a.existsSync(n)?n:s},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})}};function b(e){return Object.prototype.toString.call(e)==="[object Object]"}function _(e){return e.replace(/\/\*[\s\S]*?\*\//g,"").replace(/(^|[^:])\/\/.*$/gm,"$1").replace(/,\s*([\]}])/g,"$1")}function E(e,t,r,s=!1){let n=e?e.split(/\r?\n/):[];if(s){let l=[],g=!1,v=0,d=!1,S=0;for(let h=0;h<n.length;h++){let y=n[h],w=y.match(/^(\s*)mcp_servers:\s*$/);if(w){g=!0,v=w[1].length,l.push(y);continue}if(g){let k=y.match(/^(\s*)/)?.[1].length||0;if(y.trim()!==""&&k<=v)g=!1,d=!1;else{let $=y.match(/^(\s*)superpowers:\s*$/);if($&&$[1].length>v){d=!0,S=$[1].length;continue}if(d){if(k>S||y.trim()==="")continue;d=!1}}}l.push(y)}return l.join(`
+`)}let p="  ";for(let l of n){let g=l.match(/^(\s+)[a-zA-Z0-9_-]+:/);if(g&&g[1].length>0){p=g[1];break}}let o=JSON.stringify(t),f=JSON.stringify(r),c=[`${p}superpowers:`,`${p}${p}command: ${o}`,`${p}${p}args: ${f}`];if(!e||e.trim()==="")return`mcp_servers:
+${c.join(`
+`)}
+`;let m=n.findIndex(l=>/^\s*mcp_servers:\s*$/.test(l));if(m===-1)return`${e.trimEnd()}
+
+mcp_servers:
+${c.join(`
+`)}
+`;let u=-1;for(let l=m+1;l<n.length;l++){let g=n[l];if(/^[^\s#]/.test(g))break;if(/^\s+superpowers:\s*$/.test(g)){u=l;break}}if(u!==-1){let l=n[u].match(/^(\s*)/)?.[1].length||2,g=u+1;for(;g<n.length;){let v=n[g];if((v.match(/^(\s*)/)?.[1].length||0)>l||v.trim()==="")g++;else break}return n.splice(u,g-u,...c),n.join(`
+`)}else return n.splice(m+1,0,...c),n.join(`
+`)}function R(e,t,r,s,n=!1){let p={};if(e&&e.trim()!=="")try{let c=JSON.parse(e);b(c)?p=c:p={}}catch{try{let m=_(e),u=JSON.parse(m);b(u)?p=u:p={}}catch(m){let u=m instanceof Error?m.message:String(m);throw new Error(`Failed to parse existing JSON: ${u}`)}}let o=t==="json-servers"?"servers":"mcpServers";b(p[o])||(p[o]={});let f=p[o];return n?delete f.superpowers:t==="json-servers"?f.superpowers={command:r,args:s,type:"stdio"}:f.superpowers={command:r,args:s},JSON.stringify(p,null,2)+`
+`}function I(e,t,r=!1){let s=e;try{let c=a.lstatSync(e,{throwIfNoEntry:!1});if(c&&c.isSymbolicLink())try{s=a.realpathSync(e)}catch{let u=a.readlinkSync(e);s=i.resolve(i.dirname(e),u)}}catch{}let n=i.dirname(s);a.existsSync(n)||a.mkdirSync(n,{recursive:!0,mode:448});let p=384;if(a.existsSync(s)){try{p=a.statSync(s).mode}catch{}if(r){let c=a.readFileSync(s,"utf8"),m=`${s}.${Date.now()}.bak`;try{a.writeFileSync(m,c,{encoding:"utf8",mode:p})}catch(u){let l=u instanceof Error?u.message:String(u);throw new Error(`Failed to create safe backup before write: ${l}`)}}}let o=D.randomBytes(8).toString("hex"),f=i.join(n,`.tmp.${i.basename(s)}.${process.pid}.${o}`);try{a.writeFileSync(f,t,{encoding:"utf8",mode:p,flag:"wx"}),a.renameSync(f,s)}catch(c){try{a.existsSync(f)&&a.unlinkSync(f)}catch{}throw c}}async function O(e={}){let t=e.platform||P.platform(),r=e.homeDir||P.homedir(),s=e.appData||process.env.APPDATA,n=e.localAppData||process.env.LOCALAPPDATA,p=!!e.dryRun,o=!!e.remove,f=!!e.bun,c=e.target?e.target.toLowerCase():null,m=f?"bunx":"npx",u=["-y","superpowers-mcp"],l=[];if(!c)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(j).join("|")}>.`);let g=Object.keys(j).find(d=>d===c||j[d].aliases.includes(c));if(!g)throw new Error(`Unknown harness target: "${c}". Supported targets: ${Object.keys(j).join(", ")}`);let v=[g];for(let d of v){let S=j[d],h=S.getConfigPath(t,r,s,n),y=a.existsSync(h);if(o&&!y){l.push({target:d,name:S.name,path:h,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let w="";y&&(w=a.readFileSync(h,"utf8"));let k="";if(S.type==="yaml"?k=E(w,m,u,o):k=R(w,S.type,m,u,o),w.trim()===k.trim()&&y){l.push({target:d,name:S.name,path:h,status:"up-to-date",message:o?"Already not configured":"Already configured and up-to-date"});continue}p||I(h,k,!!e.backup),l.push({target:d,name:S.name,path:h,status:o?"removed":y?"updated":"created",message:p?`[Dry Run] Would ${o?"remove from":y?"update":"create"} ${h}`:`Successfully ${o?"removed from":y?"updated":"configured"}!`})}catch(w){let k=w instanceof Error?w.message:String(w);l.push({target:d,name:S.name,path:h,status:"error",message:k})}}return l}async function L(e=process.argv.slice(2)){let t={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let r=0;r<e.length;r++){let s=e[r];if(!(s==="setup"||s==="--setup"))if(s==="--dry-run")t.dryRun=!0;else if(s==="--remove"||s==="--uninstall")t.remove=!0;else if(s==="--bun")t.bun=!0;else if(s==="--backup")t.backup=!0;else if(s==="--target"||s==="-t"){let n=e[r+1];(!n||n.startsWith("-"))&&(console.error(`\u274C Error: Missing value for --target flag.
+`),process.exit(1)),t.target=e[++r]}else if(s.startsWith("--target=")){let n=s.split("=")[1];n||(console.error(`\u274C Error: Missing value for --target flag.
+`),process.exit(1)),t.target=n}else if(s==="--help"||s==="-h"){U();return}else!s.startsWith("-")&&!t.target&&s!=="setup"?t.target=s:s.startsWith("-")&&(console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
+`),process.exit(1))}if(console.log(`
+========================================================`),console.log("\u26A1 Superpowers MCP - Targeted Client Setup"),console.log(`========================================================
+`),!t.target){console.log(`Please select which AI Agent client you would like to configure:
+`),console.log("  npx -y superpowers-mcp setup --target antigravity # Antigravity (~/.gemini/config/mcp_config.json)"),console.log("  npx -y superpowers-mcp setup --target pi-desktop  # Pi Desktop / Pi Agent (~/.pi/agent/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target cursor     # Cursor (~/.cursor/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target copilot    # GitHub Copilot (VS Code mcp.json)"),console.log("  npx -y superpowers-mcp setup --target hermes     # Hermes Desktop / Agent"),console.log("  npx -y superpowers-mcp setup --target kimi       # Kimi Work / Kimi Code"),console.log("  npx -y superpowers-mcp setup --target claude     # Claude Desktop"),console.log(`  npx -y superpowers-mcp setup --target devin      # Devin Desktop (formerly Windsurf)
+`),console.log("\u{1F4A1} Tip:"),console.log("   You can run this setup command from ANY folder on your system."),console.log(`   It automatically targets your global config files (~/...) without needing to clone this repo.
+`),console.log("\u{1F4A1} Privacy & Safety:"),console.log("   Superpowers MCP only configures the specific client you explicitly choose."),console.log(`   It will NEVER silently scan or modify unselected environments.
+`);return}try{let r=await O(t),s=0,n=0,p=0;for(let o of r){let f=o.status==="created"||o.status==="updated"||o.status==="removed"?"\u2705":o.status==="up-to-date"?"\u2728":o.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${f} [${o.name}] (${o.status})`),console.log(`   Path: ${o.path}`),console.log(`   Info: ${o.message}
+`),o.status==="created"||o.status==="updated"||o.status==="up-to-date"||o.status==="removed"?s++:o.status==="skipped"?n++:o.status==="error"&&p++}console.log("--------------------------------------------------------"),p>0&&(console.error(`\u26A0\uFE0F Setup finished with errors: ${p} failure(s), ${s} succeeded.`),process.exit(1)),console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(r){let s=r instanceof Error?r.message:String(r);console.error(`\u274C Setup failed: ${s}
+`),process.exit(1)}}function U(){console.log(`
+Superpowers MCP - Targeted Global Setup
+
+Usage:
+  npx -y superpowers-mcp setup --target <name> [options]
+
+Options:
+  --target, -t <name>   Configure specific harness (Required):
+                        antigravity (agy, gemini), pi-desktop (pi, pi-agent), cursor,
+                        copilot (vscode), hermes, kimi, claude, devin (windsurf)
+  --bun                 Use "bunx" instead of "npx" in server commands
+  --backup              Create a timestamped .bak backup before modifying (Default: false, zero-pollution)
+  --remove              Remove superpowers MCP configuration from target
+  --dry-run             Preview changes without writing files
+  --help, -h            Show this help message
+
+Examples:
+  npx -y superpowers-mcp setup --target antigravity # Configure Antigravity only
+  npx -y superpowers-mcp setup --target pi-desktop  # Configure Pi Desktop / Pi Agent only
+  npx -y superpowers-mcp setup --target cursor      # Configure Cursor only
+  npx -y superpowers-mcp setup --target copilot     # Configure GitHub Copilot (VS Code) only
+  npx -y superpowers-mcp setup --target hermes      # Configure Hermes Desktop only
+  npx -y superpowers-mcp setup --target kimi        # Configure Kimi Work only
+  npx -y superpowers-mcp setup --target claude      # Configure Claude Desktop only
+  npx -y superpowers-mcp setup --target devin       # Configure Devin Desktop (Windsurf) only
+
+Any Directory:
+  You can run this command from ANY directory on your machine.
+  It automatically resolves global configuration paths based on your user home folder.
+
+Privacy & Safety:
+  Superpowers MCP only touches the client you explicitly choose.
+  It never bulk-modifies your environment without your consent.
+`)}0&&(module.exports={HARNESS_CONFIGS,isPlainObject,runSetup,runSetupCli,safeWriteConfig,stripJsonComments,updateJsonConfig,updateYamlConfig});

package/out/setup.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+"use strict";var F=Object.create;var C=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var J=Object.getPrototypeOf,H=Object.prototype.hasOwnProperty;var T=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},D=(e,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of W(t))!H.call(e,n)&&n!==r&&C(e,n,{get:()=>t[n],enumerable:!(s=M(t,n))||s.enumerable});return e};var x=(e,t,r)=>(r=e!=null?F(J(e)):{},D(t||!e||!e.__esModule?C(r,"default",{value:e,enumerable:!0}):r,e)),L=e=>D(C({},"__esModule",{value:!0}),e);var K={};T(K,{HARNESS_CONFIGS:()=>j,isPlainObject:()=>b,runSetup:()=>N,runSetupCli:()=>A,safeWriteConfig:()=>O,stripJsonComments:()=>E,updateJsonConfig:()=>I,updateYamlConfig:()=>R});module.exports=L(K);var a=x(require("fs")),i=x(require("path")),$=x(require("os")),_=x(require("crypto")),j={copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(e,t,r,s)=>e==="win32"?i.join(r||i.join(t,"AppData","Roaming"),"Code","User","mcp.json"):e==="darwin"?i.join(t,"Library","Application Support","Code","User","mcp.json"):i.join(t,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(e,t)=>({command:e,args:t,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(e,t)=>i.join(t,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(e,t,r,s)=>{if(e==="win32"){let n=s||i.join(t,"AppData","Local");return i.join(n,"hermes","config.yaml")}return i.join(t,".hermes","config.yaml")},type:"yaml",defaultConfig:(e,t)=>({command:e,args:t})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(e,t)=>i.join(t,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(e,t,r)=>e==="win32"?i.join(r||i.join(t,"AppData","Roaming"),"Claude","claude_desktop_config.json"):e==="darwin"?i.join(t,"Library","Application Support","Claude","claude_desktop_config.json"):i.join(t,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(e,t)=>{let r=i.join(t,".config","devin","mcp_config.json");return a.existsSync(r)?r:i.join(t,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(e,t)=>i.join(t,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(e,t,r)=>{if(e==="win32"){let p=i.join(r||i.join(t,"AppData","Roaming"),".pi","agent","mcp.json");if(a.existsSync(p))return p;let o=i.join(t,".pi","agent","mcp.json");if(a.existsSync(o))return o;let f=i.join(t,".pi","mcp.json");return a.existsSync(f)?f:o}let s=i.join(t,".pi","agent","mcp.json");if(a.existsSync(s))return s;let n=i.join(t,".pi","mcp.json");return a.existsSync(n)?n:s},type:"json-mcpServers",defaultConfig:(e,t)=>({command:e,args:t})}};function b(e){return Object.prototype.toString.call(e)==="[object Object]"}function E(e){return e.replace(/\/\*[\s\S]*?\*\//g,"").replace(/(^|[^:])\/\/.*$/gm,"$1").replace(/,\s*([\]}])/g,"$1")}function R(e,t,r,s=!1){let n=e?e.split(/\r?\n/):[];if(s){let l=[],g=!1,v=0,d=!1,S=0;for(let h=0;h<n.length;h++){let y=n[h],w=y.match(/^(\s*)mcp_servers:\s*$/);if(w){g=!0,v=w[1].length,l.push(y);continue}if(g){let k=y.match(/^(\s*)/)?.[1].length||0;if(y.trim()!==""&&k<=v)g=!1,d=!1;else{let P=y.match(/^(\s*)superpowers:\s*$/);if(P&&P[1].length>v){d=!0,S=P[1].length;continue}if(d){if(k>S||y.trim()==="")continue;d=!1}}}l.push(y)}return l.join(`
+`)}let p="  ";for(let l of n){let g=l.match(/^(\s+)[a-zA-Z0-9_-]+:/);if(g&&g[1].length>0){p=g[1];break}}let o=JSON.stringify(t),f=JSON.stringify(r),c=[`${p}superpowers:`,`${p}${p}command: ${o}`,`${p}${p}args: ${f}`];if(!e||e.trim()==="")return`mcp_servers:
+${c.join(`
+`)}
+`;let m=n.findIndex(l=>/^\s*mcp_servers:\s*$/.test(l));if(m===-1)return`${e.trimEnd()}
+
+mcp_servers:
+${c.join(`
+`)}
+`;let u=-1;for(let l=m+1;l<n.length;l++){let g=n[l];if(/^[^\s#]/.test(g))break;if(/^\s+superpowers:\s*$/.test(g)){u=l;break}}if(u!==-1){let l=n[u].match(/^(\s*)/)?.[1].length||2,g=u+1;for(;g<n.length;){let v=n[g];if((v.match(/^(\s*)/)?.[1].length||0)>l||v.trim()==="")g++;else break}return n.splice(u,g-u,...c),n.join(`
+`)}else return n.splice(m+1,0,...c),n.join(`
+`)}function I(e,t,r,s,n=!1){let p={};if(e&&e.trim()!=="")try{let c=JSON.parse(e);b(c)?p=c:p={}}catch{try{let m=E(e),u=JSON.parse(m);b(u)?p=u:p={}}catch(m){let u=m instanceof Error?m.message:String(m);throw new Error(`Failed to parse existing JSON: ${u}`)}}let o=t==="json-servers"?"servers":"mcpServers";b(p[o])||(p[o]={});let f=p[o];return n?delete f.superpowers:t==="json-servers"?f.superpowers={command:r,args:s,type:"stdio"}:f.superpowers={command:r,args:s},JSON.stringify(p,null,2)+`
+`}function O(e,t,r=!1){let s=e;try{let c=a.lstatSync(e,{throwIfNoEntry:!1});if(c&&c.isSymbolicLink())try{s=a.realpathSync(e)}catch{let u=a.readlinkSync(e);s=i.resolve(i.dirname(e),u)}}catch{}let n=i.dirname(s);a.existsSync(n)||a.mkdirSync(n,{recursive:!0,mode:448});let p=384;if(a.existsSync(s)){try{p=a.statSync(s).mode}catch{}if(r){let c=a.readFileSync(s,"utf8"),m=`${s}.${Date.now()}.bak`;try{a.writeFileSync(m,c,{encoding:"utf8",mode:p})}catch(u){let l=u instanceof Error?u.message:String(u);throw new Error(`Failed to create safe backup before write: ${l}`)}}}let o=_.randomBytes(8).toString("hex"),f=i.join(n,`.tmp.${i.basename(s)}.${process.pid}.${o}`);try{a.writeFileSync(f,t,{encoding:"utf8",mode:p,flag:"wx"}),a.renameSync(f,s)}catch(c){try{a.existsSync(f)&&a.unlinkSync(f)}catch{}throw c}}async function N(e={}){let t=e.platform||$.platform(),r=e.homeDir||$.homedir(),s=e.appData||process.env.APPDATA,n=e.localAppData||process.env.LOCALAPPDATA,p=!!e.dryRun,o=!!e.remove,f=!!e.bun,c=e.target?e.target.toLowerCase():null,m=f?"bunx":"npx",u=["-y","superpowers-mcp"],l=[];if(!c)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(j).join("|")}>.`);let g=Object.keys(j).find(d=>d===c||j[d].aliases.includes(c));if(!g)throw new Error(`Unknown harness target: "${c}". Supported targets: ${Object.keys(j).join(", ")}`);let v=[g];for(let d of v){let S=j[d],h=S.getConfigPath(t,r,s,n),y=a.existsSync(h);if(o&&!y){l.push({target:d,name:S.name,path:h,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let w="";y&&(w=a.readFileSync(h,"utf8"));let k="";if(S.type==="yaml"?k=R(w,m,u,o):k=I(w,S.type,m,u,o),w.trim()===k.trim()&&y){l.push({target:d,name:S.name,path:h,status:"up-to-date",message:o?"Already not configured":"Already configured and up-to-date"});continue}p||O(h,k,!!e.backup),l.push({target:d,name:S.name,path:h,status:o?"removed":y?"updated":"created",message:p?`[Dry Run] Would ${o?"remove from":y?"update":"create"} ${h}`:`Successfully ${o?"removed from":y?"updated":"configured"}!`})}catch(w){let k=w instanceof Error?w.message:String(w);l.push({target:d,name:S.name,path:h,status:"error",message:k})}}return l}async function A(e=process.argv.slice(2)){let t={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let r=0;r<e.length;r++){let s=e[r];if(!(s==="setup"||s==="--setup"))if(s==="--dry-run")t.dryRun=!0;else if(s==="--remove"||s==="--uninstall")t.remove=!0;else if(s==="--bun")t.bun=!0;else if(s==="--backup")t.backup=!0;else if(s==="--target"||s==="-t"){let n=e[r+1];(!n||n.startsWith("-"))&&(console.error(`\u274C Error: Missing value for --target flag.
+`),process.exit(1)),t.target=e[++r]}else if(s.startsWith("--target=")){let n=s.split("=")[1];n||(console.error(`\u274C Error: Missing value for --target flag.
+`),process.exit(1)),t.target=n}else if(s==="--help"||s==="-h"){U();return}else!s.startsWith("-")&&!t.target&&s!=="setup"?t.target=s:s.startsWith("-")&&(console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
+`),process.exit(1))}if(console.log(`
+========================================================`),console.log("\u26A1 Superpowers MCP - Targeted Client Setup"),console.log(`========================================================
+`),!t.target){console.log(`Please select which AI Agent client you would like to configure:
+`),console.log("  npx -y superpowers-mcp setup --target antigravity # Antigravity (~/.gemini/config/mcp_config.json)"),console.log("  npx -y superpowers-mcp setup --target pi-desktop  # Pi Desktop / Pi Agent (~/.pi/agent/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target cursor     # Cursor (~/.cursor/mcp.json)"),console.log("  npx -y superpowers-mcp setup --target copilot    # GitHub Copilot (VS Code mcp.json)"),console.log("  npx -y superpowers-mcp setup --target hermes     # Hermes Desktop / Agent"),console.log("  npx -y superpowers-mcp setup --target kimi       # Kimi Work / Kimi Code"),console.log("  npx -y superpowers-mcp setup --target claude     # Claude Desktop"),console.log(`  npx -y superpowers-mcp setup --target devin      # Devin Desktop (formerly Windsurf)
+`),console.log("\u{1F4A1} Tip:"),console.log("   You can run this setup command from ANY folder on your system."),console.log(`   It automatically targets your global config files (~/...) without needing to clone this repo.
+`),console.log("\u{1F4A1} Privacy & Safety:"),console.log("   Superpowers MCP only configures the specific client you explicitly choose."),console.log(`   It will NEVER silently scan or modify unselected environments.
+`);return}try{let r=await N(t),s=0,n=0,p=0;for(let o of r){let f=o.status==="created"||o.status==="updated"||o.status==="removed"?"\u2705":o.status==="up-to-date"?"\u2728":o.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${f} [${o.name}] (${o.status})`),console.log(`   Path: ${o.path}`),console.log(`   Info: ${o.message}
+`),o.status==="created"||o.status==="updated"||o.status==="up-to-date"||o.status==="removed"?s++:o.status==="skipped"?n++:o.status==="error"&&p++}console.log("--------------------------------------------------------"),p>0&&(console.error(`\u26A0\uFE0F Setup finished with errors: ${p} failure(s), ${s} succeeded.`),process.exit(1)),console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(r){let s=r instanceof Error?r.message:String(r);console.error(`\u274C Setup failed: ${s}
+`),process.exit(1)}}function U(){console.log(`
+Superpowers MCP - Targeted Global Setup
+
+Usage:
+  npx -y superpowers-mcp setup --target <name> [options]
+
+Options:
+  --target, -t <name>   Configure specific harness (Required):
+                        antigravity (agy, gemini), pi-desktop (pi, pi-agent), cursor,
+                        copilot (vscode), hermes, kimi, claude, devin (windsurf)
+  --bun                 Use "bunx" instead of "npx" in server commands
+  --backup              Create a timestamped .bak backup before modifying (Default: false, zero-pollution)
+  --remove              Remove superpowers MCP configuration from target
+  --dry-run             Preview changes without writing files
+  --help, -h            Show this help message
+
+Examples:
+  npx -y superpowers-mcp setup --target antigravity # Configure Antigravity only
+  npx -y superpowers-mcp setup --target pi-desktop  # Configure Pi Desktop / Pi Agent only
+  npx -y superpowers-mcp setup --target cursor      # Configure Cursor only
+  npx -y superpowers-mcp setup --target copilot     # Configure GitHub Copilot (VS Code) only
+  npx -y superpowers-mcp setup --target hermes      # Configure Hermes Desktop only
+  npx -y superpowers-mcp setup --target kimi        # Configure Kimi Work only
+  npx -y superpowers-mcp setup --target claude      # Configure Claude Desktop only
+  npx -y superpowers-mcp setup --target devin       # Configure Devin Desktop (Windsurf) only
+
+Any Directory:
+  You can run this command from ANY directory on your machine.
+  It automatically resolves global configuration paths based on your user home folder.
+
+Privacy & Safety:
+  Superpowers MCP only touches the client you explicitly choose.
+  It never bulk-modifies your environment without your consent.
+`)}A().catch(e=>{let t=e instanceof Error?e.message:String(e);console.error(`\u274C Fatal error: ${t}`),process.exit(1)});0&&(module.exports={HARNESS_CONFIGS,isPlainObject,runSetup,runSetupCli,safeWriteConfig,stripJsonComments,updateJsonConfig,updateYamlConfig});

package/package.json

@@ -2,7 +2,7 @@
   "name": "superpowers-mcp",
   "displayName": "Superpowers MCP",
   "description": "Superpowers skills library (TDD, debugging, collaboration workflows) as an MCP server for VSCode and Antigravity",
-  "version": "6.3.2",
+  "version": "6.3.4",
   "publisher": "superpowers",
   "license": "MIT",
   "repository": {
@@ -23,22 +23,27 @@
     "agent"
   ],
   "bin": {
-    "superpowers-mcp": "./out/server.js"
+    "superpowers-mcp": "./out/server.js",
+    "superpowers-setup": "./out/setup.js"
   },
   "files": [
     "out/server.js",
+    "out/setup.js",
+    "out/setup-runner.js",
+    "scripts",
     "skills"
   ],
   "overrides": {
-    "@hono/node-server": "2.0.11",
-    "fast-uri": "4.1.2",
-    "hono": "4.13.0"
+    "@hono/node-server": "^2.1.1",
+    "fast-uri": "^4.1.3",
+    "hono": "^4.13.7",
+    "qs": "^6.16.0"
   },
   "scripts": {
     "build": "node esbuild.js --production",
     "watch": "node esbuild.js --watch",
     "pretest": "npm run build",
-    "test": "node tests/edge_cases_test.js && node tests/run_test.js && node tests/brainstorm_server_test.js",
+    "test": "node tests/edge_cases_test.js && node tests/run_test.js && node tests/brainstorm_server_test.js && node tests/prompts_compositions_test.js && node tests/setup_test.js",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {

package/scripts/copy-skills.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/**
+ * Copy skills from the parent superpowers repository into the extension's
+ * own skills/ directory so they are included in the .vsix package.
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const src = path.join(__dirname, "..", "..", "target-learn", "skills");
+const dest = path.join(__dirname, "..", "skills");
+
+function copyRecursive(from, to) {
+    try {
+        if (!fs.existsSync(from)) {
+            console.error(`Source not found: ${from}`);
+            process.exit(1);
+        }
+
+        if (!fs.existsSync(to)) {
+            fs.mkdirSync(to, { recursive: true });
+        }
+
+        const entries = fs.readdirSync(from, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(from, entry.name);
+            const destPath = path.join(to, entry.name);
+
+            // 防禦性設計：過濾符號連結防止無限迴圈或任意讀寫
+            if (entry.isSymbolicLink()) {
+                console.warn(`Warning: Skipping symbolic link: ${srcPath}`);
+                continue;
+            }
+
+            if (entry.isDirectory()) {
+                copyRecursive(srcPath, destPath);
+            } else if (entry.isFile()) {
+                fs.copyFileSync(srcPath, destPath);
+            }
+        }
+    } catch (err) {
+        console.error(`Fatal error copying files from "${from}" to "${to}":`, err);
+        process.exit(1);
+    }
+}
+
+copyRecursive(src, dest);
+console.log(`Skills copied from ${src} to ${dest}`);

package/scripts/install.ps1

@@ -0,0 +1,59 @@
+# ==============================================================================
+# Superpowers MCP - One-Click Global Installer (Windows PowerShell)
+# Usage:
+#   irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1 | iex
+#   & ([scriptblock]::Create((irm https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.ps1))) -Target cursor
+#   .\scripts\install.ps1 -Target cursor
+# ==============================================================================
+
+[CmdletBinding()]
+param (
+    [string]$Target = "",
+    [switch]$Bun,
+    [switch]$Remove,
+    [switch]$Backup,
+    [switch]$DryRun
+)
+
+$ErrorActionPreference = "Stop"
+
+Write-Host ""
+Write-Host "========================================================" -ForegroundColor Cyan
+Write-Host "⚡ Superpowers MCP - One-Click Global Setup (Windows)" -ForegroundColor Cyan
+Write-Host "========================================================" -ForegroundColor Cyan
+Write-Host ""
+
+$argsList = @()
+if ($Target) { $argsList += "--target", $Target }
+if ($Bun) { $argsList += "--bun" }
+if ($Remove) { $argsList += "--remove" }
+if ($Backup) { $argsList += "--backup" }
+if ($DryRun) { $argsList += "--dry-run" }
+
+# Check for local setup.js
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path -ErrorAction SilentlyContinue
+$localSetup = if ($scriptDir) { Join-Path $scriptDir "setup.js" } else { "" }
+
+if ($localSetup -and (Test-Path $localSetup) -and (Get-Command node -ErrorAction SilentlyContinue)) {
+    Write-Host "📦 Using local setup engine..." -ForegroundColor Green
+    & node $localSetup @argsList
+    exit $LASTEXITCODE
+}
+
+# Check for bunx or npx
+$runner = $null
+if (Get-Command bunx -ErrorAction SilentlyContinue) {
+    $runner = "bunx"
+} elseif (Get-Command npx -ErrorAction SilentlyContinue) {
+    $runner = "npx"
+}
+
+if ($runner) {
+    Write-Host "🚀 Running global setup via $runner..." -ForegroundColor Green
+    & $runner -y superpowers-mcp setup @argsList
+    exit $LASTEXITCODE
+}
+
+Write-Host "❌ Error: Node.js (npx) or Bun (bunx) is required to run Superpowers MCP." -ForegroundColor Red
+Write-Host "Please install Node.js from https://nodejs.org or Bun from https://bun.sh and try again." -ForegroundColor Yellow
+exit 1

package/scripts/install.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# Superpowers MCP - One-Click Global Installer (macOS & Linux)
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/Poseidoncode/superpowers-mcp/main/scripts/install.sh | bash -s -- --target <client>
+#   ./scripts/install.sh --target <antigravity|pi-desktop|cursor|copilot|hermes|kimi|claude|devin>
+# ==============================================================================
+
+set -euo pipefail
+
+echo ""
+echo "========================================================"
+echo "⚡ Superpowers MCP - One-Click Global Setup (macOS / Linux)"
+echo "========================================================"
+echo ""
+
+# Find Node / Bun runtime
+RUNNER=""
+if command -v bunx >/dev/null 2>&1; then
+    RUNNER="bunx"
+elif command -v npx >/dev/null 2>&1; then
+    RUNNER="npx"
+fi
+
+# Check if running from local repository clone safely
+SCRIPT_DIR=""
+if [ -n "${BASH_SOURCE[0]:-}" ]; then
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd || echo "")"
+fi
+
+if [ -n "$SCRIPT_DIR" ] && [ -f "$SCRIPT_DIR/setup.js" ] && command -v node >/dev/null 2>&1; then
+    echo "📦 Using local setup engine..."
+    exec node "$SCRIPT_DIR/setup.js" "$@"
+fi
+
+if [ -n "$RUNNER" ]; then
+    echo "🚀 Running global setup via $RUNNER..."
+    $RUNNER -y superpowers-mcp setup "$@"
+    exit $?
+fi
+
+echo "❌ Error: Node.js (npx) or Bun (bunx) is required to run Superpowers MCP."
+echo "Please install Node.js from https://nodejs.org or Bun from https://bun.sh and try again."
+exit 1

package/scripts/setup.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Superpowers MCP - Global Setup Forwarder Wrapper
+ * Forwards calls to compiled out/setup.js (Single Source of Truth: src/setup-runner.ts)
+ */
+
+const path = require("path");
+const fs = require("fs");
+
+const compiledRunner = path.join(__dirname, "..", "out", "setup-runner.js");
+
+if (!fs.existsSync(compiledRunner)) {
+    const { execSync } = require("child_process");
+    try {
+        execSync("node esbuild.js", { cwd: path.join(__dirname, ".."), stdio: "inherit" });
+    } catch (e) {
+        console.error("Failed to build out/setup-runner.js automatically:", e.message);
+        process.exit(1);
+    }
+}
+
+const runner = require(compiledRunner);
+
+module.exports = runner;
+
+if (require.main === module) {
+    runner.runSetupCli().catch((err) => {
+        console.error("❌ Fatal error during setup execution:", err);
+        process.exit(1);
+    });
+}

package/skills/brainstorming/spec-document-reviewer-prompt.md

@@ -22,6 +22,7 @@ Subagent (general-purpose):
     | Consistency | Internal contradictions, conflicting requirements |
     | Clarity | Requirements ambiguous enough to cause someone to build the wrong thing |
     | Scope | Focused enough for a single plan — not covering multiple independent subsystems |
+    | Architecture | Units with clear boundaries, well-defined interfaces, independently understandable and testable |
     | YAGNI | Unrequested features, over-engineering |
 
     ## Calibration

package/skills/subagent-driven-development/implementer-prompt.md

@@ -17,6 +17,7 @@ Subagent (general-purpose):
 
     Read your task brief first: [BRIEF_FILE]
     It contains the full task text from the plan.
+    If your task brief specifies a **Recommended Skill** (e.g. `superpowers:test-driven-development`), adhere strictly to that skill's workflow and principles during implementation.
 
     ## Context
 

package/skills/using-superpowers/SKILL.md

@@ -30,6 +30,15 @@ When multiple skills apply, process skills come first — they set the approach,
 - "Let's build X" → superpowers:brainstorming first, then implementation skills.
 - "Fix this bug" → superpowers:systematic-debugging first, then domain skills.
 
+## Skill Compositions & Pipelines
+
+Complex engineering workflows chain multiple skills end-to-end (see `docs/skill-compositions.md`):
+
+- **Feature Pipeline:** `brainstorming` → `writing-plans` → `using-git-worktrees` → `subagent-driven-development` (with `test-driven-development`) → `verification-before-completion` → `requesting-code-review` → `finishing-a-development-branch`
+- **Troubleshooting Pipeline:** `systematic-debugging` → `using-git-worktrees` → `dispatching-parallel-agents` → `test-driven-development` → `verification-before-completion` → `requesting-code-review`
+- **Refactoring Pipeline:** `brainstorming` → `writing-plans` (skeleton-first) → `using-git-worktrees` → `subagent-driven-development` → `verification-before-completion` → `requesting-code-review`
+
+
 ## Red Flags
 
 These thoughts mean STOP—you're rationalizing:
@@ -57,6 +66,8 @@ If your harness appears here, read its reference file for special instructions:
 - Pi: `references/pi-tools.md`
 - Antigravity: `references/antigravity-tools.md`
 - Hermes Agent: `references/hermes-tools.md`
+- Devin CLI: `references/devin-tools.md`
+- OpenCode: `references/opencode-tools.md`
 
 ## User Instructions
 

package/skills/using-superpowers/references/devin-tools.md

@@ -0,0 +1,41 @@
+# Devin CLI Tool Mapping
+
+Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Devin CLI these resolve to the tools below.
+
+## Tools
+
+| Action skills request | Devin CLI tool |
+|---|---|
+| Read a file | `read_file` / `view_file` |
+| Create a new file | `write_to_file` |
+| Edit a file (targeted patch) | `replace_file_content` / `edit_file` |
+| Run a shell command | `run_command` |
+| Search file contents | `grep_search` |
+| Find files by name | `find_by_name` / `list_dir` |
+| Fetch a URL / read a webpage | `read_url_content` / `browser` |
+| Search the web | `search_web` |
+| Dispatch a subagent | `invoke_subagent` / `spawn_agent` |
+| Task tracking | `task_list` / session todo list |
+| Ask user question | `ask_question` |
+| Invoke a skill | Native `skill` tool or `read_skill` via MCP |
+
+## Instructions file
+
+When a skill mentions "your instructions file," on Devin CLI this is **`DEVIN.md`** or **`AGENTS.md`** in the project root directory.
+
+## Invoking a skill
+
+Devin CLI auto-discovers skills from installed plugins. To invoke a superpowers skill, invoke the native skill runner or call the MCP tool:
+
+```
+skill(name="brainstorming")
+```
+
+If native skill resolution is unavailable, fall back to reading the skill file directly or via the MCP server's `read_skill` tool.
+
+## Subagent dispatch
+
+When executing Subagent-Driven Development (SDD) or parallel dispatch, use Devin's subagent capability (`invoke_subagent`):
+
+- **Implementers**: Dispatch focused implementer subagents for single task isolation.
+- **Reviewers**: Dispatch fresh, independent reviewer subagents to review against specifications.

package/skills/using-superpowers/references/opencode-tools.md

@@ -0,0 +1,32 @@
+# OpenCode Tool Mapping
+
+Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On OpenCode these resolve to the tools below.
+
+## Tools
+
+| Action skills request | OpenCode tool |
+|---|---|
+| Read a file | `read_file` |
+| Create a new file | `write_file` |
+| Edit a file (targeted patch) | `edit_file` |
+| Run a shell command | `bash` / `terminal` |
+| Search file contents | `grep` / `search_files` |
+| Find files by name | `find_files` |
+| Fetch a URL / read a webpage | `fetch_url` |
+| Search the web | `web_search` |
+| Invoke a skill | `use_skill(name="...")` or MCP `read_skill` |
+| List available skills | `find_skills` or MCP `list_skills` |
+
+## Instructions file
+
+When a skill mentions "your instructions file," on OpenCode this is **`AGENTS.md`** or **`OPENCODE.md`** in the project root directory.
+
+## Invoking a skill
+
+OpenCode discovers registered skills via its plugin ecosystem or MCP server. To invoke a skill:
+
+```
+use_skill(name="brainstorming")
+```
+
+Or when running through the Superpowers MCP Server, use `read_skill(skill_name="brainstorming")`.

package/skills/writing-plans/SKILL.md

@@ -108,6 +108,8 @@ include this section.]
 ````markdown
 ### Task N: [Component Name]
 
+**Recommended Skill:** `superpowers:test-driven-development` (or relevant skill)
+
 **Files:**
 - Create: `exact/path/to/file.py`
 - Modify: `exact/path/to/existing.py:123-145`
@@ -119,6 +121,7 @@ include this section.]
   and return types. A task's implementer sees only their own task; this
   block is how they learn the names and types neighboring tasks use.]
 
+
 - [ ] **Step 1: Write the failing test**
 
 ```python

package/skills/writing-plans/plan-document-reviewer-prompt.md

@@ -22,6 +22,7 @@ Subagent (general-purpose):
     | Completeness | TODOs, placeholders, incomplete tasks, missing steps |
     | Spec Alignment | Plan covers spec requirements, no major scope creep |
     | Task Decomposition | Tasks have clear boundaries, steps are actionable |
+    | Architecture | File structure has units with clear boundaries, no files growing too large to reason about |
     | Buildability | Could an engineer follow this plan without getting stuck? |
 
     ## Calibration