cc-setup

Claude Code supports plugins (skills, hooks, agents) and MCP servers — but adding them to a new project means remembering install IDs, setting up marketplaces, and running multiple CLI commands every time.

cc-setup lets you define your preferred tools once, then add them to any project with a single command.

1. Create ~/.cc-setup.json with your go-to plugins and MCP servers
2. Run cc-setup in any project
3. Pick from your list, choose the scope, done

It ships with a small built-in list of popular plugins, but the real value is your own curated list — set it up once, reuse everywhere.

Add your preferred Claude Code plugins and MCP servers to any project in seconds.

Install

# Run directly
npx @biswaviraj/cc-setup@latest

# Or install globally
pnpm add -g @biswaviraj/cc-setup@latest
cc-setup

Custom tools

Create ~/.cc-setup.json to add your own plugins and MCP servers to the picker:

{
  "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:

# 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