MCPcopy
hub / github.com/davepoon/buildwithclaude

github.com/davepoon/buildwithclaude @1.2.4 sqlite

repository ↗ · DeepWiki ↗ · release 1.2.4 ↗
426 symbols 1,274 edges 108 files 49 documented · 12%
README

Claude Code Subagents & Commands Collection

Open Source npm version License: MIT PRs Welcome GitHub stars

A comprehensive collection of specialized AI subagents and slash commands for Claude Code, designed to enhance development workflows with domain-specific expertise and powerful automation.

🌐 Now with a Web UI and CLI Tool!

Browse, search, and install both subagents and commands instantly at buildwithclaude.com

Claude Code Subagents Homepage

Browse Subagents

Browse Commands

🚀 CLI Tool for Easy Installation

Install and manage subagents and commands directly from your terminal with our new CLI tool:

# Install the CLI for current user
npm install -g bwc-cli

# Initialize user configuration (default)
bwc init

# Or initialize project configuration (team sharing)
bwc init --project

# Add subagents or commands (goes to project if project config exists)
bwc add --agent python-pro
bwc add --command dockerize

# Browse and install interactively
bwc add

# Check configuration status
bwc status
bwc status --verify-mcp  # Deep MCP server verification

# List available items
bwc list --agents
bwc list --commands
bwc list --mcps

# Search for specific tools
bwc search python

Learn more about the CLI tool at buildwithclaude.com/docs/cli

🔌 MCP Server Support (New!) - Docker & Remote

Connect Claude to external tools through two providers: - Docker MCP: 100+ containerized servers for local tools - Remote MCP: SSE/HTTP endpoints for cloud services

MCP Servers

# Docker MCP Servers (requires Docker Desktop)
bwc add --mcp postgres --docker-mcp --scope project
bwc add --mcp redis --docker-mcp --scope user

# Remote MCP Servers (SSE/HTTP)
bwc add --mcp linear-server --transport sse \
  --url https://mcp.linear.app/sse --scope project

bwc add --mcp api-server --transport http \
  --url https://api.example.com --header "Authorization: Bearer token" \
  --scope project

# Verify installations
bwc status --verify-mcp

# List servers by scope
bwc list --mcps              # All servers
bwc list --mcps --user       # User-installed
bwc list --mcps --project    # Project-installed

Installation Scopes

  • Local Scope: Current machine only (default)
  • User Scope: Personal servers across all projects (stored in ~/.bwc/config.json)
  • Project Scope: Team-shared servers (stored in ./bwc.config.json and ./.mcp.json)
  • Docker servers: Configured via gateway (NOT in .mcp.json)
  • Remote servers: Saved to .mcp.json for team sharing

Note: When bwc init --project is used, all subagents and commands default to project installation

MCP Provider Comparison

Docker MCP: - 🔒 Container Isolation - Maximum security - 🔑 Protected Secrets - Docker manages API keys - ✅ Verified Images - Signed by Docker - 📦 100+ Servers - Pre-configured catalog

Remote MCP (Claude CLI): - ☁️ Cloud Services - Direct API connections - 🔐 Custom Auth - Headers and tokens - 🌍 SSE/HTTP - Real-time and REST - 🤝 Team Sharing - Via .mcp.json

Learn more: buildwithclaude.com/mcp-servers

Overview

This repository contains: - 43+ Specialized Subagents: AI experts in specific domains, automatically invoked based on context or explicitly called when needed - 39+ Slash Commands: Community-contributed commands for automating tasks, managing projects, and enhancing workflows - 100+ MCP Servers: Secure connections to databases, APIs, and external tools via Docker containers

Quick Start

💡 Tip: For easier installation and management, use our CLI tool (npm install -g bwc-cli)

Install Everything (Recommended)

# Clone the repository
git clone https://github.com/davepoon/claude-code-subagents-collection.git
cd claude-code-subagents-collection

# Install all subagents
find subagents -name "*.md" -exec cp {} ~/.claude/agents/ \;

# Install all commands
find commands -name "*.md" -exec cp {} ~/.claude/commands/ \;

# Restart Claude Code to load everything

Install Only Subagents

# Clone and install subagents
git clone https://github.com/davepoon/claude-code-subagents-collection.git
find claude-code-subagents-collection/subagents -name "*.md" -exec cp {} ~/.claude/agents/ \;

Install Only Commands

# Clone and install commands
git clone https://github.com/davepoon/claude-code-subagents-collection.git
find claude-code-subagents-collection/commands -name "*.md" -exec cp {} ~/.claude/commands/ \;

Available Subagents

🏗️ Development & Architecture

  • backend-architect - Design RESTful APIs, microservice boundaries, and database schemas
  • frontend-developer - Build Next.js applications with shadcn/ui, React Server Components, and Tailwind CSS
  • mobile-developer - Develop React Native or Flutter apps with native integrations
  • graphql-architect - Design GraphQL schemas, resolvers, and federation
  • directus-developer - Build and customize Directus applications with extensions, hooks, and API integrations
  • drupal-developer - Build and customize Drupal applications with custom modules, themes, and integrations

💻 Language Specialists

  • python-pro - Write idiomatic Python code with advanced features and optimizations
  • golang-pro - Write idiomatic Go code with goroutines, channels, and interfaces
  • rust-pro - Write idiomatic Rust code with ownership, lifetimes, and type safety
  • typescript-expert - Write type-safe TypeScript with advanced type system features

🚀 Infrastructure & Operations

  • devops-troubleshooter - Debug production issues, analyze logs, and fix deployment failures
  • deployment-engineer - Configure CI/CD pipelines, Docker containers, and cloud deployments
  • cloud-architect - Design AWS/Azure/GCP infrastructure and optimize cloud costs
  • database-optimizer - Optimize SQL queries, design efficient indexes, and handle database migrations

🛡️ Quality & Security

  • code-reviewer - Expert code review for quality, security, and maintainability
  • security-auditor - Review code for vulnerabilities and ensure OWASP compliance
  • test-automator - Create comprehensive test suites with unit, integration, and e2e tests
  • performance-engineer - Profile applications, optimize bottlenecks, and implement caching strategies
  • debugger - Debugging specialist for errors, test failures, and unexpected behavior

📊 Data & AI

  • data-scientist - Data analysis expert for SQL queries, BigQuery operations, and data insights
  • data-engineer - Build ETL pipelines, data warehouses, and streaming architectures
  • ai-engineer - Build LLM applications, RAG systems, and prompt pipelines
  • ml-engineer - Implement ML pipelines, model serving, and feature engineering

🎯 Specialized Domains

  • api-documenter - Create OpenAPI/Swagger specs and write developer documentation
  • payment-integration - Integrate Stripe, PayPal, and payment processors
  • quant-analyst - Build financial models, backtest trading strategies, and analyze market data
  • legacy-modernizer - Refactor legacy codebases and implement gradual modernization
  • accessibility-specialist - Ensure web applications meet WCAG 2.1 AA/AAA standards
  • blockchain-developer - Develop smart contracts, DeFi protocols, and Web3 applications
  • game-developer - Build games with Unity, Unreal Engine, or web technologies
  • ui-ux-designer - Design user interfaces and experiences with modern design principles and accessibility standards
  • hyperledger-fabric-developer - Develop Enterprise blockchain with Hyperledger Fabric

💰 Crypto Trading

  • crypto-trader - Build cryptocurrency trading systems and integrate with exchange APIs
  • defi-strategist - Design and implement DeFi yield strategies and liquidity provision
  • crypto-analyst - Perform market analysis, on-chain analytics, and sentiment analysis
  • arbitrage-bot - Identify and execute crypto arbitrage opportunities across markets
  • crypto-risk-manager - Implement risk management systems for crypto portfolios

Installation

Prerequisites

  • Claude Code installed and configured
  • Access to the ~/.claude/agents/ and ~/.claude/commands/ directories

Quick Installation via Web UI

Visit our Web UI to browse all subagents and commands: - 📋 Copy any subagent or command's markdown content with one click - 💾 Download individual files directly - 🔍 Search and filter by category - 📖 Preview full documentation - 🤖 Browse specialized AI subagents - 🔪 Explore slash commands for automation

Note: The Web UI automatically syncs with the main branch. Newly merged subagents and commands appear within minutes of PR merge.

Manual Installation Steps

  1. Clone this repository: bash git clone https://github.com/davepoon/claude-code-subagents-collection.git cd claude-code-subagents-collection

  2. Install Subagents:

Option A: Install as User Subagents (available in all projects): ```bash # macOS/Linux - Copy all subagent files from the subagents directory find subagents -name "*.md" -exec cp {} ~/.claude/agents/ \;

# Alternative for macOS/Linux (if in the repository directory) cp subagents/*.md ~/.claude/agents/

# Windows - Copy all subagent files from the subagents directory for %f in (subagents*.md) do copy "%f" %USERPROFILE%.claude\agents\ ```

Option B: Install as Project Subagents (only for current project): ```bash # Navigate to your project directory first cd /path/to/your/project

# Create the .claude/agents directory if it doesn't exist mkdir -p .claude/agents

# macOS/Linux - Copy specific subagents you need find /path/to/claude-code-subagents-collection/subagents -name "*.md" -exec cp {} .claude/agents/ \;

# Windows - Copy specific subagents you need mkdir .claude\agents 2>nul for %f in (\path\to\claude-code-subagents-collection\subagents*.md) do copy "%f" .claude\agents\ ```

Note: Project subagents are only available in the specific project where they're installed. Use this option when you want subagents tailored to a particular project or when testing new subagents.

  1. Install Commands:

Option A: Install as User Commands (available in all projects): ```bash # macOS/Linux - Copy all command files from the commands directory find commands -name "*.md" -exec cp {} ~/.claude/commands/ \;

# Alternative for macOS/Linux (if in the repository directory) cp commands/*.md ~/.claude/commands/

# Windows - Copy all command files from the commands directory for %f in (commands*.md) do copy "%f" %USERPROFILE%.claude\commands\ ```

Option B: Install as Project Commands (only for current project): ```bash # Navigate to your project directory first cd /path/to/your/project

# Create the .claude/commands directory if it doesn't exist mkdir -p .claude/commands

# macOS/Linux - Copy specific commands you need find /path/to/claude-code-subagents-collection/commands -name "*.md" -exec cp {} .claude/commands/ \;

# Windows - Copy specific commands you need mkdir .claude\commands 2>nul for %f in (\path\to\claude-code-subagents-collection\commands*.md) do copy "%f" .claude\commands\ ```

Note: Project commands are only available in the specific project where they're installed. Use this option for project-specific commands or when testing new commands.

  1. Verify installation: ```bash # For user subagents ls ~/.claude/agents/

# For project subagents ls .claude/agents/

# For user commands ls ~/.claude/commands/

# For project commands ls .claude/commands/ ```

  1. Restart Claude Code to load the new subagents and commands

Usage

Using Subagents

Automatic Invocation

Claude Code automatically delegates to the appropriate subagent based on: - Task context and requirements - Keywords in your request - File types being worked on - Error messages or issues encountered

Explicit Invocation

You can explicitly request a specific subagent in two ways:

Method 1: Natural Language

"Use the code-reviewer to check my recent changes"
"Have the security-auditor review this authentication code"
"Get the performance-engineer to optimize this function"

Method 2: @ Mentions

"@agent-code-reviewer please check my recent changes"
"@agent-security-auditor can you review this authentication code?"
"@agent-performance-engineer help optimize this database query"

Using Commands

Commands are invoked using the / prefix followed by the command name:

/commit                     # Create a commit with staged changes
/create_pr                  # Create a pull request
/todo add "Fix bug"         # Add a todo item
/docs                       # Generate documentation
/code_analysis              # Analyze code quality

Commands can accept arguments: ``` /commit --no-verify # Skip pre-commit ho

Extension points exported contracts — how you extend this code

MCPConfigOptions (Interface)
* Configure MCP server in Claude Code using claude CLI
packages/bwc-cli/src/utils/mcp-installer.ts
InstallationModalProps (Interface)
(no doc)
web-ui/components/installation-modal.tsx
Command (Interface)
(no doc)
web-ui/lib/commands-types.ts
HomePageClientProps (Interface)
(no doc)
web-ui/app/page-client.tsx
MCPRemoveOptions (Interface)
* Options for removing MCP servers
packages/bwc-cli/src/utils/mcp-remover.ts
CommandCardProps (Interface)
(no doc)
web-ui/components/command-card.tsx
MCPServer (Interface)
(no doc)
web-ui/lib/mcp-types.ts
SubagentPageClientProps (Interface)
(no doc)
web-ui/app/subagent/[slug]/page-client.tsx

Core symbols most depended-on inside this repo

cn
called by 37
web-ui/lib/utils.ts
load
called by 32
packages/bwc-cli/src/config/manager.ts
copyToClipboard
called by 26
web-ui/app/docs/cli/page.tsx
createAddCommand
called by 21
packages/bwc-cli/src/commands/add.ts
resetInstance
called by 21
packages/bwc-cli/src/config/manager.ts
fileExists
called by 20
packages/bwc-cli/src/utils/files.ts
getInstance
called by 20
packages/bwc-cli/src/config/manager.ts
execClaudeCLI
called by 18
packages/bwc-cli/src/utils/claude-cli.ts

Shape

Function 287
Method 75
Interface 52
Class 12

Languages

TypeScript100%

Modules by API surface

packages/bwc-cli/src/config/manager.ts31 symbols
packages/bwc-cli/src/utils/docker-mcp.ts19 symbols
packages/bwc-cli/src/registry/client.ts17 symbols
packages/bwc-cli/src/commands/add.ts15 symbols
packages/bwc-cli/tests/helpers/test-utils.ts14 symbols
web-ui/lib/mcp-types.ts12 symbols
web-ui/lib/mcp-server.ts12 symbols
packages/bwc-cli/src/utils/user-input-handler.ts12 symbols
scripts/mcp-importers/registry-fetchers/docker-hub-api.js11 symbols
scripts/docker-hub-api.js11 symbols
web-ui/app/docs/cli/page.tsx10 symbols
scripts/fetch-docker-mcp.js10 symbols

Dependencies from manifests, versioned

@changesets/changelog-github0.5.1 · 1×
@changesets/cli2.29.5 · 1×
@eslint/eslintrc3 · 1×
@radix-ui/react-dialog1.1.14 · 1×
@radix-ui/react-dropdown-menu2.1.15 · 1×
@radix-ui/react-icons1.3.2 · 1×
@radix-ui/react-slot1.2.3 · 1×
@radix-ui/react-tooltip1.2.7 · 1×
@types/fs-extra11.0.4 · 1×
@types/inquirer9.0.7 · 1×
@types/js-yaml4.0.9 · 1×

For agents

$ claude mcp add buildwithclaude \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact