superpowers-mcp 6.3.5 → 6.3.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +22 -5
- package/README.ko.md +22 -5
- package/README.md +23 -6
- package/README.zh-TW.md +22 -5
- package/out/server.js +41 -39
- package/out/setup-runner.js +15 -13
- package/out/setup.js +16 -14
- package/package.json +1 -1
package/out/setup-runner.js
CHANGED
|
@@ -1,26 +1,28 @@
|
|
|
1
|
-
"use strict";var
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
"use strict";var T=Object.create;var b=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var q=Object.getPrototypeOf,N=Object.prototype.hasOwnProperty;var L=(t,e)=>{for(var o in e)b(t,o,{get:e[o],enumerable:!0})},_=(t,e,o,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of W(e))!N.call(t,r)&&r!==o&&b(t,r,{get:()=>e[r],enumerable:!(s=O(e,r))||s.enumerable});return t};var P=(t,e,o)=>(o=t!=null?T(q(t)):{},_(e||!t||!t.__esModule?b(o,"default",{value:t,enumerable:!0}):o,t)),H=t=>_(b({},"__esModule",{value:!0}),t);var J={};L(J,{HARNESS_CONFIGS:()=>k,isPlainObject:()=>A,runSetup:()=>U,runSetupCli:()=>K,safeWriteConfig:()=>D,stripJsonComments:()=>R,updateJsonConfig:()=>I,updateYamlConfig:()=>E});module.exports=H(J);var p=P(require("fs")),n=P(require("path")),v=P(require("os")),$=P(require("crypto")),k={copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(t,e,o,s)=>t==="win32"?n.join(o||n.join(e,"AppData","Roaming"),"Code","User","mcp.json"):t==="darwin"?n.join(e,"Library","Application Support","Code","User","mcp.json"):n.join(e,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(t,e)=>({command:t,args:e,type:"stdio"})},"copilot-insiders":{name:"GitHub Copilot (VS Code Insiders)",aliases:["vscode-insiders","code-insiders","insiders","insider","vscode-insider","code-insider","copilot-insider"],getConfigPath:(t,e,o,s)=>t==="win32"?n.join(o||n.join(e,"AppData","Roaming"),"Code - Insiders","User","mcp.json"):t==="darwin"?n.join(e,"Library","Application Support","Code - Insiders","User","mcp.json"):n.join(e,".config","Code - Insiders","User","mcp.json"),type:"json-servers",defaultConfig:(t,e)=>({command:t,args:e,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(t,e)=>n.join(e,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(t,e,o,s)=>{if(t==="win32"){let r=s||n.join(e,"AppData","Local");return n.join(r,"hermes","config.yaml")}return n.join(e,".hermes","config.yaml")},type:"yaml",defaultConfig:(t,e)=>({command:t,args:e})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(t,e)=>n.join(e,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(t,e,o)=>t==="win32"?n.join(o||n.join(e,"AppData","Roaming"),"Claude","claude_desktop_config.json"):t==="darwin"?n.join(e,"Library","Application Support","Claude","claude_desktop_config.json"):n.join(e,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(t,e)=>{let o=n.join(e,".config","devin","mcp_config.json");return p.existsSync(o)?o:n.join(e,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(t,e)=>n.join(e,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(t,e,o)=>{if(t==="win32"){let f=n.join(o||n.join(e,"AppData","Roaming"),".pi","agent","mcp.json");if(p.existsSync(f))return f;let a=n.join(e,".pi","agent","mcp.json");if(p.existsSync(a))return a;let g=n.join(e,".pi","mcp.json");return p.existsSync(g)?g:a}let s=n.join(e,".pi","agent","mcp.json");if(p.existsSync(s))return s;let r=n.join(e,".pi","mcp.json");return p.existsSync(r)?r:s},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},qwenpaw:{name:"QwenPaw (Personal Agent Workstation)",aliases:["qwenpaw","qwen-paw","copaw"],getConfigPath:(t,e)=>{let o=n.join(e,".qwenpaw","config.json");if(p.existsSync(o))return o;let s=n.join(e,".copaw","config.json");return p.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},cline:{name:"Cline (VS Code / CLI)",aliases:["cline","claude-dev"],getConfigPath:(t,e,o)=>{let s="";if(t==="win32"?s=n.join(o||n.join(e,"AppData","Roaming"),"Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):t==="darwin"?s=n.join(e,"Library","Application Support","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):s=n.join(e,".config","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"),p.existsSync(s))return s;let r=n.join(e,".cline","data","settings","cline_mcp_settings.json");return p.existsSync(r)?r:s},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},kilo:{name:"Kilo Code",aliases:["kilo","kilocode","kilo-code"],getConfigPath:(t,e)=>{let o=n.join(e,".config","kilo","kilo.jsonc");if(p.existsSync(o))return o;let s=n.join(e,".config","kilo","kilo.json");return p.existsSync(s)?s:o},type:"json-mcp",defaultConfig:(t,e)=>({type:"local",command:[t,...e],enabled:!0})},qoder:{name:"Qoder",aliases:["qoder"],getConfigPath:(t,e)=>n.join(e,".qoder","settings.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},kiro:{name:"Kiro",aliases:["kiro","kiro-code"],getConfigPath:(t,e)=>n.join(e,".kiro","settings","mcp.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},trae:{name:"Trae",aliases:["trae"],getConfigPath:(t,e,o)=>{if(t==="win32"){let s=n.join(o||n.join(e,"AppData","Roaming"),"Trae","User","mcp.json");if(p.existsSync(s))return s;let r=n.join(o||n.join(e,"AppData","Roaming"),"Trae CN","User","mcp.json");return p.existsSync(r)?r:s}else if(t==="darwin"){let s=n.join(e,"Library","Application Support","Trae","User","mcp.json");if(p.existsSync(s))return s;let r=n.join(e,"Library","Application Support","Trae CN","User","mcp.json");return p.existsSync(r)?r:s}else{let s=n.join(e,".config","Trae","User","mcp.json");if(p.existsSync(s))return s;let r=n.join(e,".config","Trae CN","User","mcp.json");return p.existsSync(r)?r:s}},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})}};function A(t){return Object.prototype.toString.call(t)==="[object Object]"}function R(t,e=!1){if(!t)return"";if(!e)try{return JSON.parse(t),t}catch{}let o=t.length,s=[],r=!1,f=!1,a=!1,g=!1,l=-1;for(let c=0;c<o;c++){let i=t[c],u=c+1<o?t[c+1]:"";if(a){(i===`
|
|
2
|
+
`||i==="\r")&&(a=!1,s.push(i));continue}if(g){i==="*"&&u==="/"&&(g=!1,c++);continue}if(r){s.push(i),f?f=!1:i==="\\"?f=!0:i==='"'&&(r=!1);continue}if(i==='"'){r=!0,f=!1,l=-1,s.push(i);continue}if(i==="/"&&u==="/"){a=!0,c++;continue}if(i==="/"&&u==="*"){g=!0,c++;continue}if(i===","){l=s.length,s.push(i);continue}if(i==="}"||i==="]"){l!==-1&&(s[l]=" ",l=-1),s.push(i);continue}i!==" "&&i!==" "&&i!==`
|
|
3
|
+
`&&i!=="\r"&&(l=-1),s.push(i)}return s.join("")}function E(t,e,o,s=!1){let r=t?t.split(/\r?\n/):[];if(s){let u=[],d=!1,h=0,m=!1,w=0;for(let j=0;j<r.length;j++){let y=r[j],C=y.match(/^(\s*)mcp_servers:\s*$/);if(C){d=!0,h=C[1].length,u.push(y);continue}if(d){let S=y.match(/^(\s*)/)?.[1].length||0;if(y.trim()!==""&&S<=h)d=!1,m=!1;else{let x=y.match(/^(\s*)superpowers:\s*$/);if(x&&x[1].length>h){m=!0,w=x[1].length;continue}if(m){if(S>w||y.trim()==="")continue;m=!1}}}u.push(y)}return u.join(`
|
|
4
|
+
`)}let f=" ";for(let u of r){let d=u.match(/^(\s+)[a-zA-Z0-9_-]+:/);if(d&&d[1].length>0){f=d[1];break}}let a=JSON.stringify(e),g=JSON.stringify(o),l=[`${f}superpowers:`,`${f}${f}command: ${a}`,`${f}${f}args: ${g}`];if(!t||t.trim()==="")return`mcp_servers:
|
|
5
|
+
${l.join(`
|
|
4
6
|
`)}
|
|
5
|
-
`;let
|
|
7
|
+
`;let c=r.findIndex(u=>/^\s*mcp_servers:\s*$/.test(u));if(c===-1)return`${t.trimEnd()}
|
|
6
8
|
|
|
7
9
|
mcp_servers:
|
|
8
|
-
${
|
|
10
|
+
${l.join(`
|
|
9
11
|
`)}
|
|
10
|
-
`;let
|
|
11
|
-
`)}else return r.splice(
|
|
12
|
-
`)}function I(t,e,s,
|
|
13
|
-
`}function
|
|
14
|
-
`),process.exit(1)),e.target=t[++
|
|
15
|
-
`),process.exit(1)),e.target=r}else if(
|
|
12
|
+
`;let i=-1;for(let u=c+1;u<r.length;u++){let d=r[u];if(/^[^\s#]/.test(d))break;if(/^\s+superpowers:\s*$/.test(d)){i=u;break}}if(i!==-1){let u=r[i].match(/^(\s*)/)?.[1].length||2,d=i+1;for(;d<r.length;){let h=r[d];if((h.match(/^(\s*)/)?.[1].length||0)>u||h.trim()==="")d++;else break}return r.splice(i,d-i,...l),r.join(`
|
|
13
|
+
`)}else return r.splice(c+1,0,...l),r.join(`
|
|
14
|
+
`)}function I(t,e,o,s,r=!1,f){let a={};if(t&&t.trim()!=="")try{let c=JSON.parse(t);A(c)?a=c:a={}}catch{try{let i=R(t,!0),u=JSON.parse(i);A(u)?a=u:a={}}catch(i){let u=i instanceof Error?i.message:String(i);throw new Error(`Failed to parse existing JSON: ${u}`)}}let g="mcpServers";e==="json-servers"?g="servers":e==="json-mcp"&&(g="mcp"),A(a[g])||(a[g]={});let l=a[g];return r?delete l.superpowers:f?l.superpowers=f:e==="json-servers"?l.superpowers={command:o,args:s,type:"stdio"}:e==="json-mcp"?l.superpowers={type:"local",command:[o,...s],enabled:!0}:l.superpowers={command:o,args:s},JSON.stringify(a,null,2)+`
|
|
15
|
+
`}function D(t,e,o=!1){let s=t;try{let l=p.lstatSync(t,{throwIfNoEntry:!1});if(l&&l.isSymbolicLink()){try{s=p.realpathSync(t)}catch{let m=p.readlinkSync(t);s=n.resolve(n.dirname(t),m)}let c=n.normalize(n.resolve(s)).toLowerCase(),i=n.normalize(n.resolve(v.tmpdir())).toLowerCase();if(!(c===i||c.startsWith(i+n.sep))&&(["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(h=>c===h||c.startsWith(h+n.sep))||c==="/var"||c.startsWith("/var"+n.sep)&&!c.startsWith("/var/folders"+n.sep)||c==="/private/var"||c.startsWith("/private/var"+n.sep)&&!c.startsWith("/private/var/folders"+n.sep)))throw new Error(`Refusing to write to unsafe symlink target: ${s}`)}}catch(l){if(l instanceof Error&&l.message.includes("Refusing to write to unsafe symlink target"))throw l}let r=n.dirname(s);p.existsSync(r)||p.mkdirSync(r,{recursive:!0,mode:448});let f=384;if(p.existsSync(s)){try{f=p.statSync(s).mode}catch{}if(o){let l=p.readFileSync(s,"utf8"),c=`${s}.${Date.now()}.bak`;try{p.writeFileSync(c,l,{encoding:"utf8",mode:f})}catch(i){let u=i instanceof Error?i.message:String(i);throw new Error(`Failed to create safe backup before write: ${u}`)}}}let a=$.randomBytes(8).toString("hex"),g=n.join(r,`.tmp.${n.basename(s)}.${process.pid}.${a}`);try{p.writeFileSync(g,e,{encoding:"utf8",mode:f,flag:"wx"}),p.renameSync(g,s)}catch(l){try{p.existsSync(g)&&p.unlinkSync(g)}catch{}throw l}}async function U(t={}){let e=t.platform||v.platform(),o=t.homeDir||v.homedir(),s=t.appData||process.env.APPDATA,r=t.localAppData||process.env.LOCALAPPDATA,f=!!t.dryRun,a=!!t.remove,g=!!t.bun,l=t.target?t.target.toLowerCase():null,c=g?"bunx":"npx",i=["-y","superpowers-mcp"],u=[];if(!l)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(k).join("|")}>.`);let d=Object.keys(k).find(m=>m===l||k[m].aliases.includes(l));if(!d)throw new Error(`Unknown harness target: "${l}". Supported targets: ${Object.keys(k).join(", ")}`);let h=[d];for(let m of h){let w=k[m],j=w.getConfigPath(e,o,s,r),y=p.existsSync(j);if(a&&!y){u.push({target:m,name:w.name,path:j,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let C="";y&&(C=p.readFileSync(j,"utf8"));let S="";if(w.type==="yaml")S=E(C,c,i,a);else{let x=typeof w.defaultConfig=="function"?w.defaultConfig(c,i):void 0;S=I(C,w.type,c,i,a,x)}if(C.trim()===S.trim()&&y){u.push({target:m,name:w.name,path:j,status:"up-to-date",message:a?"Already not configured":"Already configured and up-to-date"});continue}f||D(j,S,!!t.backup),u.push({target:m,name:w.name,path:j,status:a?"removed":y?"updated":"created",message:f?`[Dry Run] Would ${a?"remove from":y?"update":"create"} ${j}`:`Successfully ${a?"removed from":y?"updated":"configured"}!`})}catch(C){let S=C instanceof Error?C.message:String(C);u.push({target:m,name:w.name,path:j,status:"error",message:S})}}return u}async function K(t=process.argv.slice(2)){let e={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let o=0;o<t.length;o++){let s=t[o];if(!(s==="setup"||s==="--setup"))if(s==="--dry-run")e.dryRun=!0;else if(s==="--remove"||s==="--uninstall")e.remove=!0;else if(s==="--bun")e.bun=!0;else if(s==="--backup")e.backup=!0;else if(s==="--target"||s==="-t"){let r=t[o+1];(!r||r.startsWith("-"))&&(console.error(`\u274C Error: Missing value for --target flag.
|
|
16
|
+
`),process.exit(1)),e.target=t[++o]}else if(s.startsWith("--target=")){let r=s.split("=")[1];r||(console.error(`\u274C Error: Missing value for --target flag.
|
|
17
|
+
`),process.exit(1)),e.target=r}else if(s==="--help"||s==="-h"){M();return}else!s.startsWith("-")&&!e.target&&s!=="setup"?e.target=s:s.startsWith("-")&&(console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
|
|
16
18
|
`),process.exit(1))}if(console.log(`
|
|
17
19
|
========================================================`),console.log("\u26A1 Superpowers MCP - Targeted Client Setup"),console.log(`========================================================
|
|
18
20
|
`),!e.target){console.log(`Please select which AI Agent client you would like to configure:
|
|
19
21
|
`),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 copilot-insiders # GitHub Copilot (VS Code Insiders 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(" npx -y superpowers-mcp setup --target qwenpaw # QwenPaw / CoPaw (~/.qwenpaw/config.json)"),console.log(" npx -y superpowers-mcp setup --target cline # Cline (~/.../cline_mcp_settings.json)"),console.log(" npx -y superpowers-mcp setup --target kilo # Kilo Code (~/.config/kilo/kilo.jsonc)"),console.log(" npx -y superpowers-mcp setup --target qoder # Qoder (~/.qoder/settings.json)"),console.log(" npx -y superpowers-mcp setup --target kiro # Kiro (~/.kiro/settings/mcp.json)"),console.log(` npx -y superpowers-mcp setup --target trae # Trae (~/.../Trae/User/mcp.json)
|
|
20
22
|
`),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.
|
|
21
23
|
`),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.
|
|
22
|
-
`);return}try{let
|
|
23
|
-
`),a.status==="created"||a.status==="updated"||a.status==="up-to-date"||a.status==="removed"?
|
|
24
|
+
`);return}try{let o=await U(e),s=0,r=0,f=0;for(let a of o){let g=a.status==="created"||a.status==="updated"||a.status==="removed"?"\u2705":a.status==="up-to-date"?"\u2728":a.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${g} [${a.name}] (${a.status})`),console.log(` Path: ${a.path}`),console.log(` Info: ${a.message}
|
|
25
|
+
`),a.status==="created"||a.status==="updated"||a.status==="up-to-date"||a.status==="removed"?s++:a.status==="skipped"?r++:a.status==="error"&&f++}console.log("--------------------------------------------------------"),f>0&&(console.error(`\u26A0\uFE0F Setup finished with errors: ${f} failure(s), ${s} succeeded.`),process.exit(1)),console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(o){let s=o instanceof Error?o.message:String(o);console.error(`\u274C Setup failed: ${s}
|
|
24
26
|
`),process.exit(1)}}function M(){console.log(`
|
|
25
27
|
Superpowers MCP - Targeted Global Setup
|
|
26
28
|
|
package/out/setup.js
CHANGED
|
@@ -1,28 +1,30 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
"use strict";var O=Object.create;var
|
|
3
|
-
|
|
4
|
-
|
|
2
|
+
"use strict";var O=Object.create;var b=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var N=Object.getPrototypeOf,L=Object.prototype.hasOwnProperty;var H=(t,e)=>{for(var o in e)b(t,o,{get:e[o],enumerable:!0})},$=(t,e,o,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of q(e))!L.call(t,r)&&r!==o&&b(t,r,{get:()=>e[r],enumerable:!(s=W(e,r))||s.enumerable});return t};var P=(t,e,o)=>(o=t!=null?O(N(t)):{},$(e||!t||!t.__esModule?b(o,"default",{value:t,enumerable:!0}):o,t)),K=t=>$(b({},"__esModule",{value:!0}),t);var F={};H(F,{HARNESS_CONFIGS:()=>k,isPlainObject:()=>A,runSetup:()=>T,runSetupCli:()=>_,safeWriteConfig:()=>U,stripJsonComments:()=>R,updateJsonConfig:()=>D,updateYamlConfig:()=>I});module.exports=K(F);var p=P(require("fs")),n=P(require("path")),v=P(require("os")),E=P(require("crypto")),k={copilot:{name:"GitHub Copilot (VS Code)",aliases:["vscode","code","copilot"],getConfigPath:(t,e,o,s)=>t==="win32"?n.join(o||n.join(e,"AppData","Roaming"),"Code","User","mcp.json"):t==="darwin"?n.join(e,"Library","Application Support","Code","User","mcp.json"):n.join(e,".config","Code","User","mcp.json"),type:"json-servers",defaultConfig:(t,e)=>({command:t,args:e,type:"stdio"})},"copilot-insiders":{name:"GitHub Copilot (VS Code Insiders)",aliases:["vscode-insiders","code-insiders","insiders","insider","vscode-insider","code-insider","copilot-insider"],getConfigPath:(t,e,o,s)=>t==="win32"?n.join(o||n.join(e,"AppData","Roaming"),"Code - Insiders","User","mcp.json"):t==="darwin"?n.join(e,"Library","Application Support","Code - Insiders","User","mcp.json"):n.join(e,".config","Code - Insiders","User","mcp.json"),type:"json-servers",defaultConfig:(t,e)=>({command:t,args:e,type:"stdio"})},cursor:{name:"Cursor",aliases:["cursor"],getConfigPath:(t,e)=>n.join(e,".cursor","mcp.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},hermes:{name:"Hermes Desktop / Agent",aliases:["hermes","hermes-desktop"],getConfigPath:(t,e,o,s)=>{if(t==="win32"){let r=s||n.join(e,"AppData","Local");return n.join(r,"hermes","config.yaml")}return n.join(e,".hermes","config.yaml")},type:"yaml",defaultConfig:(t,e)=>({command:t,args:e})},kimi:{name:"Kimi Work / Kimi Code",aliases:["kimi","kimi-work","kimi-code"],getConfigPath:(t,e)=>n.join(e,".kimi-code","mcp.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},claude:{name:"Claude Desktop",aliases:["claude","claude-desktop"],getConfigPath:(t,e,o)=>t==="win32"?n.join(o||n.join(e,"AppData","Roaming"),"Claude","claude_desktop_config.json"):t==="darwin"?n.join(e,"Library","Application Support","Claude","claude_desktop_config.json"):n.join(e,".config","Claude","claude_desktop_config.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},devin:{name:"Devin Desktop (formerly Windsurf)",aliases:["devin","devin-desktop","windsurf","codeium"],getConfigPath:(t,e)=>{let o=n.join(e,".config","devin","mcp_config.json");return p.existsSync(o)?o:n.join(e,".codeium","windsurf","mcp_config.json")},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},antigravity:{name:"Antigravity (Google DeepMind)",aliases:["antigravity","agy","gemini"],getConfigPath:(t,e)=>n.join(e,".gemini","config","mcp_config.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},"pi-desktop":{name:"Pi Desktop / Pi Agent",aliases:["pi-desktop","pi","pi-agent"],getConfigPath:(t,e,o)=>{if(t==="win32"){let f=n.join(o||n.join(e,"AppData","Roaming"),".pi","agent","mcp.json");if(p.existsSync(f))return f;let a=n.join(e,".pi","agent","mcp.json");if(p.existsSync(a))return a;let g=n.join(e,".pi","mcp.json");return p.existsSync(g)?g:a}let s=n.join(e,".pi","agent","mcp.json");if(p.existsSync(s))return s;let r=n.join(e,".pi","mcp.json");return p.existsSync(r)?r:s},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},qwenpaw:{name:"QwenPaw (Personal Agent Workstation)",aliases:["qwenpaw","qwen-paw","copaw"],getConfigPath:(t,e)=>{let o=n.join(e,".qwenpaw","config.json");if(p.existsSync(o))return o;let s=n.join(e,".copaw","config.json");return p.existsSync(s)?s:o},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},cline:{name:"Cline (VS Code / CLI)",aliases:["cline","claude-dev"],getConfigPath:(t,e,o)=>{let s="";if(t==="win32"?s=n.join(o||n.join(e,"AppData","Roaming"),"Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):t==="darwin"?s=n.join(e,"Library","Application Support","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"):s=n.join(e,".config","Code","User","globalStorage","saoudrizwan.claude-dev","settings","cline_mcp_settings.json"),p.existsSync(s))return s;let r=n.join(e,".cline","data","settings","cline_mcp_settings.json");return p.existsSync(r)?r:s},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},kilo:{name:"Kilo Code",aliases:["kilo","kilocode","kilo-code"],getConfigPath:(t,e)=>{let o=n.join(e,".config","kilo","kilo.jsonc");if(p.existsSync(o))return o;let s=n.join(e,".config","kilo","kilo.json");return p.existsSync(s)?s:o},type:"json-mcp",defaultConfig:(t,e)=>({type:"local",command:[t,...e],enabled:!0})},qoder:{name:"Qoder",aliases:["qoder"],getConfigPath:(t,e)=>n.join(e,".qoder","settings.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},kiro:{name:"Kiro",aliases:["kiro","kiro-code"],getConfigPath:(t,e)=>n.join(e,".kiro","settings","mcp.json"),type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})},trae:{name:"Trae",aliases:["trae"],getConfigPath:(t,e,o)=>{if(t==="win32"){let s=n.join(o||n.join(e,"AppData","Roaming"),"Trae","User","mcp.json");if(p.existsSync(s))return s;let r=n.join(o||n.join(e,"AppData","Roaming"),"Trae CN","User","mcp.json");return p.existsSync(r)?r:s}else if(t==="darwin"){let s=n.join(e,"Library","Application Support","Trae","User","mcp.json");if(p.existsSync(s))return s;let r=n.join(e,"Library","Application Support","Trae CN","User","mcp.json");return p.existsSync(r)?r:s}else{let s=n.join(e,".config","Trae","User","mcp.json");if(p.existsSync(s))return s;let r=n.join(e,".config","Trae CN","User","mcp.json");return p.existsSync(r)?r:s}},type:"json-mcpServers",defaultConfig:(t,e)=>({command:t,args:e})}};function A(t){return Object.prototype.toString.call(t)==="[object Object]"}function R(t,e=!1){if(!t)return"";if(!e)try{return JSON.parse(t),t}catch{}let o=t.length,s=[],r=!1,f=!1,a=!1,g=!1,l=-1;for(let c=0;c<o;c++){let i=t[c],u=c+1<o?t[c+1]:"";if(a){(i===`
|
|
3
|
+
`||i==="\r")&&(a=!1,s.push(i));continue}if(g){i==="*"&&u==="/"&&(g=!1,c++);continue}if(r){s.push(i),f?f=!1:i==="\\"?f=!0:i==='"'&&(r=!1);continue}if(i==='"'){r=!0,f=!1,l=-1,s.push(i);continue}if(i==="/"&&u==="/"){a=!0,c++;continue}if(i==="/"&&u==="*"){g=!0,c++;continue}if(i===","){l=s.length,s.push(i);continue}if(i==="}"||i==="]"){l!==-1&&(s[l]=" ",l=-1),s.push(i);continue}i!==" "&&i!==" "&&i!==`
|
|
4
|
+
`&&i!=="\r"&&(l=-1),s.push(i)}return s.join("")}function I(t,e,o,s=!1){let r=t?t.split(/\r?\n/):[];if(s){let u=[],d=!1,h=0,m=!1,w=0;for(let j=0;j<r.length;j++){let y=r[j],C=y.match(/^(\s*)mcp_servers:\s*$/);if(C){d=!0,h=C[1].length,u.push(y);continue}if(d){let S=y.match(/^(\s*)/)?.[1].length||0;if(y.trim()!==""&&S<=h)d=!1,m=!1;else{let x=y.match(/^(\s*)superpowers:\s*$/);if(x&&x[1].length>h){m=!0,w=x[1].length;continue}if(m){if(S>w||y.trim()==="")continue;m=!1}}}u.push(y)}return u.join(`
|
|
5
|
+
`)}let f=" ";for(let u of r){let d=u.match(/^(\s+)[a-zA-Z0-9_-]+:/);if(d&&d[1].length>0){f=d[1];break}}let a=JSON.stringify(e),g=JSON.stringify(o),l=[`${f}superpowers:`,`${f}${f}command: ${a}`,`${f}${f}args: ${g}`];if(!t||t.trim()==="")return`mcp_servers:
|
|
6
|
+
${l.join(`
|
|
5
7
|
`)}
|
|
6
|
-
`;let
|
|
8
|
+
`;let c=r.findIndex(u=>/^\s*mcp_servers:\s*$/.test(u));if(c===-1)return`${t.trimEnd()}
|
|
7
9
|
|
|
8
10
|
mcp_servers:
|
|
9
|
-
${
|
|
11
|
+
${l.join(`
|
|
10
12
|
`)}
|
|
11
|
-
`;let
|
|
12
|
-
`)}else return r.splice(
|
|
13
|
-
`)}function
|
|
14
|
-
`}function U(t,e,
|
|
15
|
-
`),process.exit(1)),e.target=t[++
|
|
16
|
-
`),process.exit(1)),e.target=r}else if(
|
|
13
|
+
`;let i=-1;for(let u=c+1;u<r.length;u++){let d=r[u];if(/^[^\s#]/.test(d))break;if(/^\s+superpowers:\s*$/.test(d)){i=u;break}}if(i!==-1){let u=r[i].match(/^(\s*)/)?.[1].length||2,d=i+1;for(;d<r.length;){let h=r[d];if((h.match(/^(\s*)/)?.[1].length||0)>u||h.trim()==="")d++;else break}return r.splice(i,d-i,...l),r.join(`
|
|
14
|
+
`)}else return r.splice(c+1,0,...l),r.join(`
|
|
15
|
+
`)}function D(t,e,o,s,r=!1,f){let a={};if(t&&t.trim()!=="")try{let c=JSON.parse(t);A(c)?a=c:a={}}catch{try{let i=R(t,!0),u=JSON.parse(i);A(u)?a=u:a={}}catch(i){let u=i instanceof Error?i.message:String(i);throw new Error(`Failed to parse existing JSON: ${u}`)}}let g="mcpServers";e==="json-servers"?g="servers":e==="json-mcp"&&(g="mcp"),A(a[g])||(a[g]={});let l=a[g];return r?delete l.superpowers:f?l.superpowers=f:e==="json-servers"?l.superpowers={command:o,args:s,type:"stdio"}:e==="json-mcp"?l.superpowers={type:"local",command:[o,...s],enabled:!0}:l.superpowers={command:o,args:s},JSON.stringify(a,null,2)+`
|
|
16
|
+
`}function U(t,e,o=!1){let s=t;try{let l=p.lstatSync(t,{throwIfNoEntry:!1});if(l&&l.isSymbolicLink()){try{s=p.realpathSync(t)}catch{let m=p.readlinkSync(t);s=n.resolve(n.dirname(t),m)}let c=n.normalize(n.resolve(s)).toLowerCase(),i=n.normalize(n.resolve(v.tmpdir())).toLowerCase();if(!(c===i||c.startsWith(i+n.sep))&&(["/etc","/bin","/sbin","/usr","/root","/sys","/proc","/dev","/private/etc","c:\\windows"].some(h=>c===h||c.startsWith(h+n.sep))||c==="/var"||c.startsWith("/var"+n.sep)&&!c.startsWith("/var/folders"+n.sep)||c==="/private/var"||c.startsWith("/private/var"+n.sep)&&!c.startsWith("/private/var/folders"+n.sep)))throw new Error(`Refusing to write to unsafe symlink target: ${s}`)}}catch(l){if(l instanceof Error&&l.message.includes("Refusing to write to unsafe symlink target"))throw l}let r=n.dirname(s);p.existsSync(r)||p.mkdirSync(r,{recursive:!0,mode:448});let f=384;if(p.existsSync(s)){try{f=p.statSync(s).mode}catch{}if(o){let l=p.readFileSync(s,"utf8"),c=`${s}.${Date.now()}.bak`;try{p.writeFileSync(c,l,{encoding:"utf8",mode:f})}catch(i){let u=i instanceof Error?i.message:String(i);throw new Error(`Failed to create safe backup before write: ${u}`)}}}let a=E.randomBytes(8).toString("hex"),g=n.join(r,`.tmp.${n.basename(s)}.${process.pid}.${a}`);try{p.writeFileSync(g,e,{encoding:"utf8",mode:f,flag:"wx"}),p.renameSync(g,s)}catch(l){try{p.existsSync(g)&&p.unlinkSync(g)}catch{}throw l}}async function T(t={}){let e=t.platform||v.platform(),o=t.homeDir||v.homedir(),s=t.appData||process.env.APPDATA,r=t.localAppData||process.env.LOCALAPPDATA,f=!!t.dryRun,a=!!t.remove,g=!!t.bun,l=t.target?t.target.toLowerCase():null,c=g?"bunx":"npx",i=["-y","superpowers-mcp"],u=[];if(!l)throw new Error(`No target client specified. Please specify which client to configure using --target <${Object.keys(k).join("|")}>.`);let d=Object.keys(k).find(m=>m===l||k[m].aliases.includes(l));if(!d)throw new Error(`Unknown harness target: "${l}". Supported targets: ${Object.keys(k).join(", ")}`);let h=[d];for(let m of h){let w=k[m],j=w.getConfigPath(e,o,s,r),y=p.existsSync(j);if(a&&!y){u.push({target:m,name:w.name,path:j,status:"up-to-date",message:"Already not configured (file does not exist)"});continue}try{let C="";y&&(C=p.readFileSync(j,"utf8"));let S="";if(w.type==="yaml")S=I(C,c,i,a);else{let x=typeof w.defaultConfig=="function"?w.defaultConfig(c,i):void 0;S=D(C,w.type,c,i,a,x)}if(C.trim()===S.trim()&&y){u.push({target:m,name:w.name,path:j,status:"up-to-date",message:a?"Already not configured":"Already configured and up-to-date"});continue}f||U(j,S,!!t.backup),u.push({target:m,name:w.name,path:j,status:a?"removed":y?"updated":"created",message:f?`[Dry Run] Would ${a?"remove from":y?"update":"create"} ${j}`:`Successfully ${a?"removed from":y?"updated":"configured"}!`})}catch(C){let S=C instanceof Error?C.message:String(C);u.push({target:m,name:w.name,path:j,status:"error",message:S})}}return u}async function _(t=process.argv.slice(2)){let e={dryRun:!1,remove:!1,bun:!1,backup:!1,target:null};for(let o=0;o<t.length;o++){let s=t[o];if(!(s==="setup"||s==="--setup"))if(s==="--dry-run")e.dryRun=!0;else if(s==="--remove"||s==="--uninstall")e.remove=!0;else if(s==="--bun")e.bun=!0;else if(s==="--backup")e.backup=!0;else if(s==="--target"||s==="-t"){let r=t[o+1];(!r||r.startsWith("-"))&&(console.error(`\u274C Error: Missing value for --target flag.
|
|
17
|
+
`),process.exit(1)),e.target=t[++o]}else if(s.startsWith("--target=")){let r=s.split("=")[1];r||(console.error(`\u274C Error: Missing value for --target flag.
|
|
18
|
+
`),process.exit(1)),e.target=r}else if(s==="--help"||s==="-h"){M();return}else!s.startsWith("-")&&!e.target&&s!=="setup"?e.target=s:s.startsWith("-")&&(console.error(`\u274C Error: Unknown option "${s}". Use --help for usage.
|
|
17
19
|
`),process.exit(1))}if(console.log(`
|
|
18
20
|
========================================================`),console.log("\u26A1 Superpowers MCP - Targeted Client Setup"),console.log(`========================================================
|
|
19
21
|
`),!e.target){console.log(`Please select which AI Agent client you would like to configure:
|
|
20
22
|
`),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 copilot-insiders # GitHub Copilot (VS Code Insiders 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(" npx -y superpowers-mcp setup --target qwenpaw # QwenPaw / CoPaw (~/.qwenpaw/config.json)"),console.log(" npx -y superpowers-mcp setup --target cline # Cline (~/.../cline_mcp_settings.json)"),console.log(" npx -y superpowers-mcp setup --target kilo # Kilo Code (~/.config/kilo/kilo.jsonc)"),console.log(" npx -y superpowers-mcp setup --target qoder # Qoder (~/.qoder/settings.json)"),console.log(" npx -y superpowers-mcp setup --target kiro # Kiro (~/.kiro/settings/mcp.json)"),console.log(` npx -y superpowers-mcp setup --target trae # Trae (~/.../Trae/User/mcp.json)
|
|
21
23
|
`),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.
|
|
22
24
|
`),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.
|
|
23
|
-
`);return}try{let
|
|
24
|
-
`),a.status==="created"||a.status==="updated"||a.status==="up-to-date"||a.status==="removed"?
|
|
25
|
-
`),process.exit(1)}}function
|
|
25
|
+
`);return}try{let o=await T(e),s=0,r=0,f=0;for(let a of o){let g=a.status==="created"||a.status==="updated"||a.status==="removed"?"\u2705":a.status==="up-to-date"?"\u2728":a.status==="skipped"?"\u23ED\uFE0F ":"\u274C";console.log(`${g} [${a.name}] (${a.status})`),console.log(` Path: ${a.path}`),console.log(` Info: ${a.message}
|
|
26
|
+
`),a.status==="created"||a.status==="updated"||a.status==="up-to-date"||a.status==="removed"?s++:a.status==="skipped"?r++:a.status==="error"&&f++}console.log("--------------------------------------------------------"),f>0&&(console.error(`\u26A0\uFE0F Setup finished with errors: ${f} failure(s), ${s} succeeded.`),process.exit(1)),console.log(`\u{1F389} Setup complete! ${s} environment(s) ready.`)}catch(o){let s=o instanceof Error?o.message:String(o);console.error(`\u274C Setup failed: ${s}
|
|
27
|
+
`),process.exit(1)}}function M(){console.log(`
|
|
26
28
|
Superpowers MCP - Targeted Global Setup
|
|
27
29
|
|
|
28
30
|
Usage:
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "superpowers-mcp",
|
|
3
3
|
"displayName": "Superpowers MCP",
|
|
4
4
|
"description": "Superpowers skills library (TDD, debugging, collaboration workflows) as an MCP server for VSCode and Antigravity",
|
|
5
|
-
"version": "6.3.
|
|
5
|
+
"version": "6.3.6",
|
|
6
6
|
"publisher": "superpowers",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"repository": {
|