Claude Code Subagent Manager

Interactive installer for Claude Code subagents from the awesome-claude-code-subagents community repository.

🚀 Quick Start

Installation

# Install globally
npm install -g claude-code-subagent-manager

# Or use directly with npx
npx claude-code-subagent-manager

Usage

# Interactive CLI installer
claude-subagents

# Launch GUI interface (cross-platform)
claude-subagents --gui

# Set GitHub token for enhanced rate limits (5,000 requests/hour vs 60)
claude-subagents --token ghp_xxxxxxxxxxxxxxxxxxxx

# Browse all available subagents
claude-subagents --demo

# Show help
claude-subagents --help

GUI Interface

The package now includes a cross-platform GUI that works on Windows, macOS, and Linux:

# Launch the graphical interface
claude-subagents --gui
# or
claude-subagents -g

The GUI provides:

• ✨ Visual category browser
• 🔍 Easy agent selection with checkboxes
• ⚙️ Settings panel for GitHub token configuration
• 📊 Installation progress tracking
• 🎯 User-friendly interface for all platforms

GitHub Token (Recommended)

For the best experience, set a GitHub personal access token to increase API rate limits from 60 to 5,000 requests per hour:

1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Click "Generate new token (classic)"
3. Give it a name like "Claude Subagent Manager"
4. Select "public_repo" scope (read access to public repositories)
5. Click "Generate token" and copy it
6. Use it with: claude-subagents --token YOUR_TOKEN

The token is saved locally and used for all future API requests.

✨ Features

• 126+ Subagents: Access to the entire community collection
• Cross-Platform GUI: Electron-based interface for Windows, macOS, and Linux
• Command-Line Interface: Traditional CLI for power users and automation
• 10 Categories: Core Development, Language Specialists, Infrastructure, Quality & Security, Data & AI, Developer Experience, Specialized Domains, Business & Product, Meta Orchestration, Research & Analysis
• GitHub Token Support: Enhanced API rate limits (5,000 vs 60 requests/hour)
• Interactive Selection: Browse by category with checkbox-style selection
• Smart Installation: Handles conflicts, validates files, prompts for overwrites
• Live Updates: Fetches the latest subagents from the community repository

📋 Available Categories

| Category | Count | Description | |----------|-------|-------------| | Core Development | 12 | Backend, Frontend, Fullstack developers | | Language Specialists | 24 | Python, JavaScript, TypeScript, etc. experts | | Infrastructure | 13 | DevOps, Cloud, Containerization specialists | | Quality & Security | 13 | Testing, Security, Code review experts | | Data & AI | 13 | AI Engineers, Data Scientists, ML specialists | | Developer Experience | 11 | Tooling and Productivity experts | | Specialized Domains | 12 | Game Dev, Mobile, Embedded systems | | Business & Product | 12 | Product Managers, Business analysts | | Meta & Orchestration | 9 | Multi-agent coordination | | Research & Analysis | 7 | Research and Analysis specialists |

🎯 How It Works

1. Browse Available Subagents: See all 126+ subagents organized by category
2. Interactive Selection: Choose individual agents or entire categories
3. Automatic Installation: Downloads and installs to your .claude/agents/ directory
4. Conflict Management: Smart handling of existing agents with overwrite prompts

📖 Usage Examples

Browse All Available Subagents

claude-subagents --demo

Interactive Installation

claude-subagents

Check What's Installed

# List installed subagents
ls .claude/agents/

🛠️ Requirements

• Node.js 14.0.0 or higher
• Claude Code installed and configured

🤝 Contributing

The subagents are maintained by the community at VoltAgent/awesome-claude-code-subagents.

To contribute new subagents or improvements:

1. Visit the awesome-claude-code-subagents repository
2. Follow their contribution guidelines
3. Submit a pull request

📄 License

MIT

🔗 Links

• Claude Code
• Awesome Claude Code Subagents
• Report Issues