@webdevtoday/claude-agents
Advanced tools
AI-powered development shop with 15 specialized agents for Claude Code. Features concurrent execution, shared memory, context-forge integration, and web dashboard for 80% faster development.
🚀 Supercharge Claude Code with Specialized AI Sub-Agents for Code Review, Testing, Debugging & More
Transform your development workflow with intelligent AI assistants that excel at specific programming tasks
Installation • Quick Start • Available Agents • Documentation • Contributing
Claude Sub-Agents Manager is a powerful CLI tool that enhances Claude Code with specialized AI assistants designed for specific development tasks. Each sub-agent is an expert in its domain - from automated code reviews and test fixing to intelligent debugging and documentation generation. Install production-ready agents instantly or create custom agents tailored to your unique workflow needs.
npm install -g @webdevtoday/claude-agents
yarn global add @webdevtoday/claude-agents
git clone https://github.com/webdevtodayjason/sub-agents.git
cd sub-agents
npm install
npm link
# Initialize in your project (recommended)
claude-agents init
# Or install agents globally
claude-agents install --all
# List available agents
claude-agents list
# Use an agent via slash command
# In Claude Code:
> /review
> /test
> /debug TypeError in production
# Works seamlessly with context-forge projects
# Agents automatically detect and use PRPs:
claude-agents run api-developer --task "implement auth endpoints"
| Agent Name | Description | Slash Command |
|---|---|---|
| code-reviewer | Expert code review specialist for quality, security, and maintainability | /review |
| test-runner | Automated test execution specialist that runs tests and fixes failures | /test [pattern] |
| debugger | Expert debugging specialist for analyzing errors, stack traces, and fixing issues | /debug [error] |
| refactor | Code refactoring specialist for improving code structure, patterns, and maintainability | /refactor [target] |
| doc-writer | Documentation specialist for creating and updating technical documentation, API docs, and README files | /document [type] |
| security-scanner | Security vulnerability scanner that detects common security issues and suggests fixes | /security-scan [path] |
| shadcn-ui-builder | UI/UX specialist for designing and implementing interfaces using ShadCN UI components | /ui or /shadcn |
| project-planner | Strategic planning specialist for project decomposition and workflow management | /plan [project] |
| api-developer | Backend API development specialist for REST, GraphQL, and microservices | /api [spec] |
| frontend-developer | Frontend development specialist for modern web applications | /frontend [feature] |
| tdd-specialist | Test-Driven Development specialist for comprehensive testing strategies | /tdd [component] |
| api-documenter | API documentation specialist for OpenAPI, Swagger, and technical docs | /apidoc [endpoint] |
| devops-engineer | DevOps specialist for CI/CD, infrastructure automation, and deployment | /devops [task] |
| product-manager | Product management specialist for requirements, roadmaps, and user stories | /product [feature] |
| marketing-writer | Marketing content specialist for technical marketing and product messaging | /marketing [content] |
Your personal code quality guardian
# Install
claude-agents install code-reviewer
# Use
> /review
Intelligent test automation specialist
# Install
claude-agents install test-runner
# Use
> /test
> /test src/**/*.test.js
Expert problem solver and bug hunter
# Install
claude-agents install debugger
# Use
> /debug Cannot read property 'map' of undefined
Code transformation specialist
# Install
claude-agents install refactor
# Use
> /refactor improve performance
> /refactor apply SOLID principles
Technical writing expert
# Install
claude-agents install doc-writer
# Use
> /document API
> /document architecture
Vulnerability detection specialist
# Install
claude-agents install security-scanner
# Use
> /security-scan
> /security-scan src/api/
Your expert UI/UX implementation specialist
# Install
claude-agents install shadcn-ui-builder
# Use
> /ui create a login page
> /shadcn implement dashboard with sidebar
Strategic planning and task decomposition expert
# Install
claude-agents install project-planner
# Use
> /plan e-commerce platform
> /plan microservices migration
Backend development specialist
# Install
claude-agents install api-developer
# Use
> /api user authentication endpoints
> /api payment processing service
Modern web interface specialist
# Install
claude-agents install frontend-developer
# Use
> /frontend user dashboard
> /frontend shopping cart component
Test-driven development expert
# Install
claude-agents install tdd-specialist
# Use
> /tdd UserService class
> /tdd API integration tests
Technical documentation specialist
# Install
claude-agents install api-documenter
# Use
> /apidoc REST endpoints
> /apidoc GraphQL schema
Infrastructure and deployment expert
# Install
claude-agents install devops-engineer
# Use
> /devops GitHub Actions workflow
> /devops Kubernetes deployment
Product strategy and planning specialist
# Install
claude-agents install product-manager
# Use
> /product user onboarding flow
> /product feature prioritization
Technical marketing content expert
# Install
claude-agents install marketing-writer
# Use
> /marketing product launch post
> /marketing API feature announcement
## 📖 Documentation
### Command Reference
| Command | Description | Example |
|---------|-------------|---------|
| `init` | Initialize agents in project | `claude-agents init` |
| `init --respect-context-forge` | Init preserving context-forge | `claude-agents init --respect-context-forge` |
| `install` | Install agents interactively | `claude-agents install` |
| `install --all` | Install all available agents | `claude-agents install --all` |
| `install --project` | Install to project directory | `claude-agents install --project` |
| `list` | Show all agents | `claude-agents list` |
| `list --installed` | Show only installed agents | `claude-agents list --installed` |
| `enable <agent>` | Enable a disabled agent | `claude-agents enable code-reviewer` |
| `disable <agent>` | Disable an agent | `claude-agents disable test-runner` |
| `remove <agent>` | Remove specific agent | `claude-agents remove debugger` |
| `uninstall` | Bulk uninstall with options | `claude-agents uninstall --all --clean` |
| `info <agent>` | Show agent details | `claude-agents info debugger` |
| `create` | Create a custom agent | `claude-agents create` |
| `run <agent>` | Run agent independently | `claude-agents run marketing-writer --task "write launch post"` |
| `dashboard` | Launch web dashboard | `claude-agents dashboard` |
### Independent Agent Execution
Run agents outside of Claude Code for automation and scripting:
```bash
# Run with inline task
claude-agents run marketing-writer --task "Write launch announcement for v2.0"
# Run with task file
claude-agents run api-developer --file api-spec.md
# Interactive mode
claude-agents run tdd-specialist --interactive
Monitor and manage your agents through the web interface:
# Start dashboard on port 7842
claude-agents dashboard
# Custom port
claude-agents dashboard --port 8080
Dashboard features:
claude-agents create
Create ~/.claude/agents/my-agent.md:
---
name: my-agent
description: What this agent does and when to use it
tools: Read, Edit, Grep, Bash
---
You are an expert in [DOMAIN]. Your role is to [PURPOSE].
When invoked, you will:
1. [STEP 1]
2. [STEP 2]
3. [STEP 3]
Always ensure [KEY PRINCIPLE].
User Scope (~/.claude/agents/)
Project Scope (.claude/agents/)
--project flagAgent states are tracked in .claude-agents.json:
{
"installedAgents": {
"code-reviewer": {
"version": "1.0.0",
"scope": "user",
"installedAt": "2024-01-20T10:00:00Z"
}
},
"enabledAgents": ["code-reviewer"],
"disabledAgents": []
}
The hooks system enables automated workflows and agent coordination. Each agent can define hooks that trigger on specific events.
| Hook Type | Description | Trigger |
|---|---|---|
PostToolUse:Edit | After file edits | Any file modification |
PostToolUse:Write | After file creation | New file written |
PostToolUse:Bash | After command execution | Bash commands run |
PreToolUse | Before any tool use | Tool about to run |
TaskComplete | After task completion | Agent finishes task |
Stop | On conversation end | Session terminating |
{
"PostToolUse:Edit": {
"condition": "file.endsWith('.js')",
"commands": ["npm run lint", "npm test"]
},
"TaskComplete": {
"notify": "Task {{task_name}} completed",
"store": "agent:{{agent_name}}:last_task"
}
}
Create hooks for automatic code review after edits:
{
"hooks": {
"PostToolUse:Edit": [{
"matcher": "\\.(js|ts|py)$",
"hooks": [{
"type": "command",
"command": "echo 'Consider running /review' >&2"
}]
}]
}
}
Automatically run tests after code changes:
{
"PostToolUse:Edit": {
"condition": "file.includes('src/')",
"commands": ["npm test -- --watch=false"]
}
}
Check out our other tools for Claude Code:
Powerful hook management system for Claude Code automation
Our flagship tool for intelligent context generation and management
We love contributions! Here's how you can help:
git checkout -b feature/amazing-agent)git commit -m 'Add amazing agent')git push origin feature/amazing-agent)agents/
└── your-agent/
├── agent.md # Agent definition
├── metadata.json # Agent metadata
└── hooks.json # Optional hooks
commands/
└── your-command.md
# Enable debug mode to see where agents are being searched
DEBUG=claude-agents claude-agents run project-planner --task "test"
# Check npm global installation path
npm list -g @webdevtoday/claude-agents
# Verify agents are included in the package
ls -la $(npm root -g)/@webdevtoday/claude-agents/agents/
# Check installation
claude-agents list
# Verify agent status
claude-agents info <agent-name>
# Re-enable if disabled
claude-agents enable <agent-name>
# Run Claude with debug output
claude --debug
# Run claude-agents with debug output
DEBUG=claude-agents claude-agents run <agent> --task "test"
sudo for global installMIT License - see LICENSE file for details
Made with ❤️ by WebDev Today Jason
Building AI-powered developer tools to enhance productivity and code quality
Claude Sub-Agents Manager - Your AI-Powered Development Team in Claude Code
FAQs
AI-powered development shop with 15 specialized agents for Claude Code. Features concurrent execution, shared memory, context-forge integration, and web dashboard for 80% faster development.
We found that @webdevtoday/claude-agents demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PolinRider expands across npm, Packagist, Go modules, and Chrome extensions, using hidden loaders to target developer environments.
Security News
Open source attacks are accelerating as AI coding agents pull in dependencies faster, with less human review.
Research
/Security News
Malicious Chrome and Firefox extensions posed as free VPNs while stealing clipboard data through later extension updates.