@biswaviraj/cc-setup 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Biswajeet Das
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# cc-setup
+
+Add your preferred Claude Code plugins and MCP servers to any project in seconds.
+
+![cc-setup demo](./demo.gif)
+
+```bash
+npx @biswaviraj/cc-setup
+```
+
+Pick what you need, choose the scope, done. No manual config editing.
+
+## Install
+
+```bash
+# Run directly
+npx @biswaviraj/cc-setup
+
+# Or install globally
+pnpm add -g @biswaviraj/cc-setup
+cc-setup
+```
+
+## Custom tools
+
+Create `~/.cc-setup.json` to add your own plugins and MCP servers to the picker:
+
+```json
+{
+  "defaults": ["superpowers", "context-mode", "my-plugin"],
+  "plugins": [
+    {
+      "value": "my-plugin",
+      "label": "My Plugin",
+      "hint": "what it does",
+      "install": "my-plugin@my-marketplace",
+      "marketplace": "org/repo"
+    }
+  ],
+  "mcpServers": [
+    {
+      "value": "my-server",
+      "label": "My Server",
+      "hint": "what it does",
+      "command": "npx my-mcp-server"
+    }
+  ]
+}
+```
+
+Your entries are merged with the built-in list. No duplicates.
+
+### Plugin fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `value` | yes | Unique ID |
+| `label` | yes | Display name |
+| `hint` | yes | Short description |
+| `install` | yes | Plugin install ID (e.g. `my-plugin` or `my-plugin@marketplace`) |
+| `marketplace` | no | GitHub `org/repo` for non-official marketplaces |
+
+### MCP Server fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `value` | yes | Unique ID |
+| `label` | yes | Display name |
+| `hint` | yes | Short description |
+| `command` | yes | The command to run (e.g. `npx my-mcp-server`) |
+
+## Quick mode
+
+Set `defaults` in your config, then:
+
+```bash
+# Install defaults, just pick scope
+cc-setup --quick
+
+# Fully non-interactive
+cc-setup --quick --scope local
+```
+
+## Scopes
+
+| Scope | Where | Use case |
+|-------|-------|----------|
+| `local` | `.claude/settings.local.json` | Just for you, this project |
+| `project` | `.claude/settings.json` | Shared with team (committed to git) |
+| `user` | `~/.claude/settings.json` | All projects on this machine |
+
+## How it works
+
+Under the hood, `cc-setup` runs:
+
+- `claude plugins marketplace add <repo>` for custom marketplaces
+- `claude plugins install <plugin> -s <scope>` for plugins
+- `claude mcp add <name> -s <scope> -- <command>` for MCP servers
+
+That's it. No magic.
+
+## License
+
+MIT

package/{index.mjs → dist/index.js}

@@ -1,62 +1,54 @@
 #!/usr/bin/env node
 
+// src/index.ts
 import * as p from "@clack/prompts";
-import { execSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
+import { execSync } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
 import pc from "picocolors";
-
-// ── Built-in Registry ───────────────────────────────────────
-// Popular plugins & servers. Users can extend via ~/.cc-setup.json
-
-const BUILTIN_PLUGINS = [
+var BUILTIN_PLUGINS = [
   {
     value: "superpowers",
     label: "Superpowers",
     hint: "brainstorming, TDD, debugging, plans, worktrees",
-    install: "superpowers",
+    install: "superpowers"
   },
   {
     value: "frontend-design",
     label: "Frontend Design",
     hint: "production-grade UI components",
-    install: "frontend-design",
+    install: "frontend-design"
   },
   {
     value: "context-mode",
     label: "Context Mode",
     hint: "context window optimization",
     install: "context-mode@context-mode",
-    marketplace: "mksglu/context-mode",
+    marketplace: "mksglu/context-mode"
   },
   {
     value: "context7",
     label: "Context7",
     hint: "library & framework docs lookup",
     install: "context7-plugin@context7-marketplace",
-    marketplace: "upstash/context7",
+    marketplace: "upstash/context7"
   },
   {
     value: "feature-dev",
     label: "Feature Dev",
     hint: "guided feature development",
-    install: "feature-dev",
+    install: "feature-dev"
   },
   {
     value: "mongodb",
     label: "MongoDB",
     hint: "database ops, schema design, queries",
-    install: "mongodb",
-  },
+    install: "mongodb"
+  }
 ];
-
-const BUILTIN_MCP = [];
-
-// ── Config ──────────────────────────────────────────────────
-
-const CONFIG_PATH = join(homedir(), ".cc-setup.json");
-
+var BUILTIN_MCP = [];
+var CONFIG_PATH = join(homedir(), ".cc-setup.json");
 function loadConfig() {
   if (!existsSync(CONFIG_PATH)) return null;
   try {
@@ -65,43 +57,35 @@ function loadConfig() {
     return null;
   }
 }
-
 function merge(builtin, user) {
   if (!user?.length) return builtin;
   const seen = new Set(builtin.map((t) => t.value));
   return [...builtin, ...user.filter((t) => !seen.has(t.value))];
 }
-
-// ── Helpers ─────────────────────────────────────────────────
-
 function run(cmd) {
   try {
     return {
       ok: true,
-      output: execSync(cmd, { encoding: "utf-8", stdio: "pipe" }).trim(),
+      output: execSync(cmd, { encoding: "utf-8", stdio: "pipe" }).trim()
     };
   } catch (e) {
-    return { ok: false, output: (e.stderr || e.message).trim() };
+    const err = e;
+    return { ok: false, output: (err.stderr || err.message).trim() };
   }
 }
-
 function parseArgs() {
   const args = process.argv.slice(2);
   return {
     quick: args.includes("--quick") || args.includes("-q"),
     scope: args.find((_, i, a) => a[i - 1] === "--scope") || null,
-    help: args.includes("--help") || args.includes("-h"),
+    help: args.includes("--help") || args.includes("-h")
   };
 }
-
-// ── Main ────────────────────────────────────────────────────
-
 async function main() {
   const args = parseArgs();
-
   if (args.help) {
     console.log(`
-  ${pc.bold("cc-setup")} — Add Claude Code plugins & MCP servers to any project
+  ${pc.bold("cc-setup")} \u2014 Add Claude Code plugins & MCP servers to any project
 
   ${pc.dim("Usage:")}
     cc-setup                        Interactive picker
@@ -126,35 +110,24 @@ async function main() {
 `);
     process.exit(0);
   }
-
   console.clear();
   p.intro(`${pc.bgCyan(pc.black(" cc-setup "))} ${pc.dim("v1.0.0")}`);
-
-  // Preflight
   const check = run("claude --version");
   if (!check.ok) {
     p.cancel(
-      "Claude Code CLI not found. Install: npm i -g @anthropic-ai/claude-code",
+      "Claude Code CLI not found. Install: npm i -g @anthropic-ai/claude-code"
     );
     process.exit(1);
   }
   p.log.info(`${pc.dim("Claude Code")} ${check.output}`);
-
-  // Load & merge
   const config = loadConfig();
   if (config) p.log.info(`${pc.dim("Config loaded from")} ${CONFIG_PATH}`);
-
   const plugins = merge(BUILTIN_PLUGINS, config?.plugins);
   const mcpServers = merge(BUILTIN_MCP, config?.mcpServers);
   const defaults = config?.defaults || [];
-
   const pluginMap = new Map(plugins.map((pl) => [pl.value, pl]));
   const mcpMap = new Map(mcpServers.map((m) => [m.value, m]));
-
-  // ── Select ────────────────────────────────────────────────
-
   let selectedIds;
-
   if (args.quick) {
     if (!defaults.length) {
       p.cancel('No defaults configured. Add "defaults" to ~/.cc-setup.json');
@@ -168,108 +141,87 @@ async function main() {
       groups["Plugins"] = plugins.map((t) => ({
         value: t.value,
         label: t.label,
-        hint: t.hint,
+        hint: t.hint
       }));
     if (mcpServers.length)
       groups["MCP Servers"] = mcpServers.map((t) => ({
         value: t.value,
         label: t.label,
-        hint: t.hint,
+        hint: t.hint
       }));
-
-    selectedIds = await p.groupMultiselect({
+    const result = await p.groupMultiselect({
       message: "Pick tools to add",
       options: groups,
-      required: false,
+      required: false
     });
-
-    if (p.isCancel(selectedIds) || !selectedIds.length) {
+    if (p.isCancel(result) || !result.length) {
       p.cancel("Nothing selected.");
       process.exit(0);
     }
+    selectedIds = result;
   }
-
   const pluginIds = selectedIds.filter((id) => pluginMap.has(id));
   const mcpIds = selectedIds.filter((id) => mcpMap.has(id));
-
   if (!pluginIds.length && !mcpIds.length) {
     p.cancel("Nothing to install.");
     process.exit(0);
   }
-
-  // ── Scope ─────────────────────────────────────────────────
-
   let scope = args.scope;
-
   if (!scope) {
-    scope = await p.select({
+    const result = await p.select({
       message: "Install scope",
       options: [
         {
           value: "local",
           label: "This project",
-          hint: ".claude/settings.local.json",
+          hint: ".claude/settings.local.json"
         },
         {
           value: "project",
           label: "Shared with team",
-          hint: ".claude/settings.json (committed)",
+          hint: ".claude/settings.json (committed)"
         },
         {
           value: "user",
           label: "Global",
-          hint: "~/.claude/settings.json",
-        },
-      ],
+          hint: "~/.claude/settings.json"
+        }
+      ]
     });
-
-    if (p.isCancel(scope)) {
+    if (p.isCancel(result)) {
       p.cancel("Cancelled.");
       process.exit(0);
     }
+    scope = result;
   }
-
-  // ── Install ───────────────────────────────────────────────
-
   const s = p.spinner();
   const results = [];
-
   for (const id of pluginIds) {
     const plugin = pluginMap.get(id);
-
     if (plugin.marketplace) {
       s.start(`Adding marketplace for ${plugin.label}...`);
       run(`claude plugins marketplace add ${plugin.marketplace}`);
       s.stop(`Marketplace ready for ${plugin.label}`);
     }
-
     s.start(`Installing ${plugin.label}...`);
     const result = run(`claude plugins install ${plugin.install} -s ${scope}`);
-    s.stop(`${result.ok ? pc.green("✓") : pc.yellow("⚠")} ${plugin.label}`);
+    s.stop(`${result.ok ? pc.green("\u2713") : pc.yellow("\u26A0")} ${plugin.label}`);
     results.push({ name: plugin.label, ...result });
   }
-
   for (const id of mcpIds) {
     const mcp = mcpMap.get(id);
     s.start(`Adding ${mcp.label}...`);
     const result = run(
-      `claude mcp add ${mcp.value} -s ${scope} -- ${mcp.command}`,
+      `claude mcp add ${mcp.value} -s ${scope} -- ${mcp.command}`
     );
-    s.stop(`${result.ok ? pc.green("✓") : pc.yellow("⚠")} ${mcp.label}`);
+    s.stop(`${result.ok ? pc.green("\u2713") : pc.yellow("\u26A0")} ${mcp.label}`);
     results.push({ name: mcp.label, ...result });
   }
-
-  // ── Summary ───────────────────────────────────────────────
-
-  const summary = results
-    .map((r) => {
-      if (r.ok) return `  ${pc.green("✓")} ${r.name}`;
-      return `  ${pc.red("✗")} ${r.name} ${pc.dim(`— ${r.output.split("\n")[0]}`)}`;
-    })
-    .join("\n");
-
+  const summary = results.map((r) => {
+    if (r.ok) return `  ${pc.green("\u2713")} ${r.name}`;
+    return `  ${pc.red("\u2717")} ${r.name} ${pc.dim(`\u2014 ${r.output.split("\n")[0]}`)}`;
+  }).join("\n");
   p.note(summary, "Results");
   p.outro("Restart Claude Code to activate new tools.");
 }
-
 main().catch(console.error);

package/package.json

@@ -1,15 +1,23 @@
 {
   "name": "@biswaviraj/cc-setup",
-  "version": "1.0.0",
-  "description": "Interactive CLI to add Claude Code plugins & MCP servers to any project",
+  "version": "1.0.2",
+  "description": "Add your preferred Claude Code plugins and MCP servers to any project in seconds",
   "type": "module",
   "bin": {
-    "cc-setup": "./index.mjs"
+    "cc-setup": "./dist/index.mjs"
   },
+  "files": [
+    "dist"
+  ],
   "author": {
     "name": "BiswaViraj",
     "url": "https://github.com/BiswaViraj"
   },
+  "homepage": "https://github.com/BiswaViraj/cc-setup#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BiswaViraj/cc-setup.git"
+  },
   "keywords": [
     "claude",
     "claude-code",
@@ -22,5 +30,13 @@
   "dependencies": {
     "@clack/prompts": "^0.11.0",
     "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsup": "^8.0.0",
+    "typescript": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsup"
   }
 }

package/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "enabledPlugins": {
-    "superpowers@claude-plugins-official": true,
-    "context-mode@context-mode": true,
-    "feature-dev@claude-plugins-official": true
-  }
-}