claude-setup scans your project files — package.json, docker-compose.yml, .env.example, source code — and generates everything Claude Code needs:

Generated	What it does
CLAUDE.md	Project context — stack, structure, commands, conventions
.mcp.json	MCP server connections — auto-detected from your dependencies
settings.json	Hooks — auto-format, token tracking, build triggers
skills/	Reusable patterns for your workflow
commands/	Slash commands that work inside Claude Code

Every line comes from evidence in your project files. No guessing.

MCP servers are auto-configured

claude-setup detects your databases and services automatically:

Finds PostgreSQL, MongoDB, Redis, MySQL from your deps, docker-compose, or env files
Checks if the service is installed locally (psql, mongosh, redis-cli)
Uses the right connection URL — no broken ${VARNAME} that fails silently
Formats commands for your OS (cmd /c npx on Windows, npx everywhere else)

After init

These slash commands work inside Claude Code:

Command	What it does
`/stack-sync`	Detect file changes, update your setup
`/stack-add`	Add a capability — searches 400+ marketplace plugins first
`/stack-status`	Show project state, snapshots, token usage
`/stack-doctor`	Validate environment, auto-fix issues
`/stack-restore`	Time-travel to any snapshot
`/stack-remove`	Remove a capability cleanly

`/stack-add` searches the marketplace for you

Say what you want — it searches 400+ community plugins and 13 official Anthropic plugins, downloads and installs matching skills automatically. No manual steps.

/stack-add
> "E2E testing and Stripe integration"

`/stack-sync` shows what changed

Every sync creates a snapshot and shows a color-coded diff:

Changes since 2026-03-28T14:32:01.904Z:
  +2 added  ~3 modified  -1 deleted

  Added files:
    + src/api/payments.ts (48 lines)
    + src/api/webhooks.ts (32 lines)

  Modified files:
    ~ package.json (+3 lines, -1 lines)
    ~ src/index.ts (+8 lines, -2 lines)

Claude Code sees the actual line-level changes and updates your setup surgically.

Snapshots

Every init and sync saves a full snapshot. You can jump to any point in time:

/stack-restore

init ──> sync#1 ──> sync#2 ──> sync#3 (you are here)
              |
              └── jump back here anytime

Snapshots are never deleted. Go back, go forward, freely.

All CLI commands

npx claude-setup                         # Interactive menu
npx claude-setup init                    # Full project setup
npx claude-setup sync                    # Checkpoint + update
npx claude-setup add "postgres and testing"  # Add capabilities
npx claude-setup status                  # Dashboard
npx claude-setup doctor                  # Validate everything
npx claude-setup doctor --fix            # Auto-fix issues
npx claude-setup restore                 # Time-travel
npx claude-setup compare                 # Diff two snapshots
npx claude-setup remove "redis"          # Remove cleanly
npx claude-setup export                  # Save as template
npx claude-setup init --template file    # Apply a template

Configuration

Auto-generated on first run. Edit .claude-setup.json if needed:

{
  "maxSourceFiles": 15,
  "maxDepth": 6,
  "tokenBudget": { "init": 12000, "sync": 6000, "add": 3000 },
  "digestMode": true
}

Supported platforms

Platform	Status	MCP format
Windows	Full support	`cmd /c npx -y <pkg>`
macOS	Full support + Homebrew detection	`npx -y <pkg>`
Linux	Full support	`npx -y <pkg>`
WSL	Full support + Windows host access	`npx -y <pkg>`