CLI Tool for Claude Code

Add subagents and commands from your terminal with the bwc CLI

Quick Install

npm install -g bwc-cli

Easy Installation

Install and manage subagents with simple commands

Bulk Operations

Add multiple items at once with interactive mode

Project Config

Team-wide settings with version control

Installation

Use directly without installation

# Run any command with npx
npx bwc-cli@latest init
npx bwc-cli@latest add --agent python-pro
npx bwc-cli@latest list --agents

Core Commands

bwc init

Initialize configuration

# Initialize global configuration
bwc init

# Initialize project-level configuration
bwc init --project

bwc add

Add subagents or commands

# Add specific subagent
bwc add --agent python-pro

# Add specific command
bwc add --command dockerize

# Interactive mode (browse and select)
bwc add

💡 Interactive Mode: Use SPACE to select/deselect items, ENTER to confirm

bwc list

Browse available items

# List all items
bwc list

# List subagents only
bwc list --agents

# Show installed items
bwc list --installed

# Filter by category
bwc list --category language-specialists

bwc search

Search for subagents and commands

# Search both subagents and commands
bwc search python

# Search subagents only
bwc search python --agents

# Search commands only
bwc search docker --commands

bwc install

Install all dependencies from configuration

# Install all items listed in config
bwc install

# Perfect for team onboarding:
# 1. Clone project with bwc.config.json
# 2. Run bwc install
# 3. All team members have same setup!

Configuration

Located at ~/.bwc/config.json

{
  "version": "1.0",
  "registry": "https://buildwithclaude.com/registry.json",
  "paths": {
    "subagents": "~/.claude/agents/",
    "commands": "~/.claude/commands/"
  },
  "installed": {
    "subagents": ["python-pro", "react-wizard"],
    "commands": ["dockerize", "test-runner"]
  }
}

Use Cases

Team Onboarding

Share your Claude Code setup with your team

# Initialize project configuration
bwc init --project

# Add project-specific subagents
bwc add --agent backend-architect
bwc add --agent database-admin
bwc add --command dockerize

# Commit configuration
git add bwc.config.json
git commit -m "Add Claude Code configuration"

# Team members install dependencies
git clone <repo>
bwc install

Bulk Installation

Add multiple items at once

# Search for testing-related tools
bwc search test

# Add multiple items interactively
bwc add
# Select "Subagent"
# Select category or "All"
# Use SPACE to select multiple items
# Press ENTER to install all

CI/CD Integration

Automate Claude Code setup in your pipelines

# .github/workflows/setup.yml
- name: Install bwc CLI
  run: npm install -g bwc-cli
  
- name: Install Claude dependencies
  run: bwc install

Troubleshooting

Configuration not found

Run bwc init to create configuration

Failed to fetch registry

Check your internet connection. The CLI needs access to buildwithclaude.com

Permission denied

On macOS/Linux, you may need to use sudo npm install -g bwc-cli

Interactive mode not selecting

Use SPACE to select items (not Enter). Selected items show a ● marker. Press ENTER only to confirm.

Next Steps

→ Browse available subagents → Explore slash commands → Contribute your own subagents → Report issues or suggest features