@biswaviraj/cc-setup 1.0.0 → 1.0.1

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.
Files changed (2) hide show
  1. package/README.md +122 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,122 @@
1
+ # cc-setup
2
+
3
+ Add your preferred Claude Code plugins and MCP servers to any project in seconds.
4
+
5
+ ```bash
6
+ npx @biswaviraj/cc-setup
7
+ ```
8
+
9
+ ```
10
+ cc-setup v1.0.0
11
+
12
+ i Claude Code 1.0.37
13
+
14
+ ? Pick tools to add
15
+ > Plugins
16
+ [ ] Superpowers brainstorming, TDD, debugging, plans, worktrees
17
+ [ ] Frontend Design production-grade UI components
18
+ [ ] Context Mode context window optimization
19
+ [ ] Context7 library & framework docs lookup
20
+ [ ] Feature Dev guided feature development
21
+ [ ] MongoDB database ops, schema design, queries
22
+
23
+ ? Install scope
24
+ > This project .claude/settings.local.json
25
+ Shared with team .claude/settings.json (committed)
26
+ Global ~/.claude/settings.json
27
+ ```
28
+
29
+ Pick what you need, choose the scope, done. No manual config editing.
30
+
31
+ ## Install
32
+
33
+ ```bash
34
+ # Run directly
35
+ npx @biswaviraj/cc-setup
36
+
37
+ # Or install globally
38
+ pnpm add -g @biswaviraj/cc-setup
39
+ cc-setup
40
+ ```
41
+
42
+ ## Custom tools
43
+
44
+ Create `~/.cc-setup.json` to add your own plugins and MCP servers to the picker:
45
+
46
+ ```json
47
+ {
48
+ "defaults": ["superpowers", "context-mode", "my-plugin"],
49
+ "plugins": [
50
+ {
51
+ "value": "my-plugin",
52
+ "label": "My Plugin",
53
+ "hint": "what it does",
54
+ "install": "my-plugin@my-marketplace",
55
+ "marketplace": "org/repo"
56
+ }
57
+ ],
58
+ "mcpServers": [
59
+ {
60
+ "value": "my-server",
61
+ "label": "My Server",
62
+ "hint": "what it does",
63
+ "command": "npx my-mcp-server"
64
+ }
65
+ ]
66
+ }
67
+ ```
68
+
69
+ Your entries are merged with the built-in list. No duplicates.
70
+
71
+ ### Plugin fields
72
+
73
+ | Field | Required | Description |
74
+ |-------|----------|-------------|
75
+ | `value` | yes | Unique ID |
76
+ | `label` | yes | Display name |
77
+ | `hint` | yes | Short description |
78
+ | `install` | yes | Plugin install ID (e.g. `my-plugin` or `my-plugin@marketplace`) |
79
+ | `marketplace` | no | GitHub `org/repo` for non-official marketplaces |
80
+
81
+ ### MCP Server fields
82
+
83
+ | Field | Required | Description |
84
+ |-------|----------|-------------|
85
+ | `value` | yes | Unique ID |
86
+ | `label` | yes | Display name |
87
+ | `hint` | yes | Short description |
88
+ | `command` | yes | The command to run (e.g. `npx my-mcp-server`) |
89
+
90
+ ## Quick mode
91
+
92
+ Set `defaults` in your config, then:
93
+
94
+ ```bash
95
+ # Install defaults, just pick scope
96
+ cc-setup --quick
97
+
98
+ # Fully non-interactive
99
+ cc-setup --quick --scope local
100
+ ```
101
+
102
+ ## Scopes
103
+
104
+ | Scope | Where | Use case |
105
+ |-------|-------|----------|
106
+ | `local` | `.claude/settings.local.json` | Just for you, this project |
107
+ | `project` | `.claude/settings.json` | Shared with team (committed to git) |
108
+ | `user` | `~/.claude/settings.json` | All projects on this machine |
109
+
110
+ ## How it works
111
+
112
+ Under the hood, `cc-setup` runs:
113
+
114
+ - `claude plugins marketplace add <repo>` for custom marketplaces
115
+ - `claude plugins install <plugin> -s <scope>` for plugins
116
+ - `claude mcp add <name> -s <scope> -- <command>` for MCP servers
117
+
118
+ That's it. No magic.
119
+
120
+ ## License
121
+
122
+ MIT
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@biswaviraj/cc-setup",
3
- "version": "1.0.0",
4
- "description": "Interactive CLI to add Claude Code plugins & MCP servers to any project",
3
+ "version": "1.0.1",
4
+ "description": "Add your preferred Claude Code plugins and MCP servers to any project in seconds",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "cc-setup": "./index.mjs"