{"id":29806275,"url":"https://github.com/webdevtodayjason/sub-agents","last_synced_at":"2025-09-21T05:05:33.991Z","repository":{"id":306405861,"uuid":"1026110486","full_name":"webdevtodayjason/sub-agents","owner":"webdevtodayjason","description":"Claude Code Sub Agent Manager. A simple Manager for adding Claude Code Sub Agents with hooks and custom slash commands.","archived":false,"fork":false,"pushed_at":"2025-07-28T17:42:22.000Z","size":184,"stargazers_count":136,"open_issues_count":1,"forks_count":26,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-21T05:03:33.958Z","etag":null,"topics":["a-agent","agents","anthropic-claude","claude","claude-ai","claude-code","context-forge","semfreak","sub-agents"],"latest_commit_sha":null,"homepage":"https://github.com/webdevtodayjason/sub-agents","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webdevtodayjason.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-25T10:20:44.000Z","updated_at":"2025-09-20T18:06:15.000Z","dependencies_parsed_at":"2025-07-25T15:16:19.205Z","dependency_job_id":"200d0485-9b6d-4158-bb0c-ada40b7ed0b0","html_url":"https://github.com/webdevtodayjason/sub-agents","commit_stats":null,"previous_names":["webdevtodayjason/sub-agents"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/webdevtodayjason/sub-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fsub-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fsub-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fsub-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fsub-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webdevtodayjason","download_url":"https://codeload.github.com/webdevtodayjason/sub-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fsub-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276195600,"owners_count":25601145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-21T02:00:07.055Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a-agent","agents","anthropic-claude","claude","claude-ai","claude-code","context-forge","semfreak","sub-agents"],"created_at":"2025-07-28T14:05:55.854Z","updated_at":"2025-09-21T05:05:33.984Z","avatar_url":"https://github.com/webdevtodayjason.png","language":"JavaScript","readme":"# Claude Sub-Agents Manager - AI-Powered Development Assistants for Claude Code\n\n\u003cdiv align=\"center\"\u003e\n\n![Claude Sub-Agents](https://img.shields.io/badge/Claude-Sub--Agents-blue?style=for-the-badge\u0026logo=anthropic)\n[![npm version](https://img.shields.io/npm/v/@webdevtoday/claude-agents?style=flat-square)](https://www.npmjs.com/package/@webdevtoday/claude-agents)\n[![npm downloads](https://img.shields.io/npm/dm/@webdevtoday/claude-agents?style=flat-square)](https://www.npmjs.com/package/@webdevtoday/claude-agents)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![GitHub release](https://img.shields.io/github/release/webdevtodayjason/sub-agents.svg?style=flat-square)](https://github.com/webdevtodayjason/sub-agents/releases)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n[![Made with Love](https://img.shields.io/badge/Made%20with-❤️-red.svg?style=flat-square)](https://github.com/webdevtodayjason)\n\n**🚀 Supercharge Claude Code with Specialized AI Sub-Agents for Code Review, Testing, Debugging \u0026 More**\n\n**Transform your development workflow with intelligent AI assistants that excel at specific programming tasks**\n\n[Installation](#-installation) • [Quick Start](#-quick-start) • [Available Agents](#-available-sub-agents) • [Documentation](#-documentation) • [Contributing](#-contributing)\n\n\u003c/div\u003e\n\n---\n\n## 🎯 What is Claude Sub-Agents Manager?\n\nClaude 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.\n\n### ✨ Why Claude Sub-Agents?\n\n- **🧠 Specialized Intelligence**: Each agent is an expert in its domain\n- **⚡ Zero Configuration**: Pre-built agents work out of the box\n- **🎨 Fully Customizable**: Create agents that match your workflow\n- **🔄 Smart Context Management**: Agents operate in isolated contexts\n- **🛠️ Developer First**: Built by developers, for developers\n- **🔗 Context-Forge Integration**: Seamlessly works with context-forge projects and PRPs\n\n### 🎉 New in v1.4.0 - Context-Forge Integration\n\n- **🛠️ Full Context-Forge Support**: Automatic detection and smart integration\n- **📦 Init Command**: `claude-agents init` for one-command project setup\n- **🧹 Uninstall Command**: Bulk removal with cleanup options\n- **📁 Smart Command Organization**: No conflicts with existing context-forge commands\n- **⚡ Concurrent Execution Rules**: Enforces best practices for maximum performance\n- **📝 CLAUDE.md Integration**: Appends configuration without overwriting\n- **🎯 PRP Awareness**: Agents understand and work with your existing PRPs\n\n## 🚀 Installation\n\n### NPM (Recommended)\n```bash\nnpm install -g @webdevtoday/claude-agents\n```\n\n### Yarn\n```bash\nyarn global add @webdevtoday/claude-agents\n```\n\n### From Source\n```bash\ngit clone https://github.com/webdevtodayjason/sub-agents.git\ncd sub-agents\nnpm install\nnpm link\n```\n\n## ⚡ Quick Start\n\n### For New Projects\n```bash\n# Initialize all agents in your project\nclaude-agents init\n\n# List available agents\nclaude-agents list\n```\n\n### For Context-Forge Projects\n```bash\n# Initialize with context-forge awareness\nclaude-agents init --respect-context-forge\n\n# Agents will:\n# - Detect existing PRPs and CLAUDE.md\n# - Place commands in .claude/commands/agents/\n# - Append to CLAUDE.md without overwriting\n# - Work alongside your existing setup\n```\n\n### Example Agent Tasks\n\n```bash\n# Project Planning - Reads and understands your PRPs\nclaude-agents run project-planner --task \"Create implementation roadmap from existing PRPs\"\nclaude-agents run project-planner --task \"Break down auth-prp into sprint tasks\"\n\n# API Development - PRP-aware implementation\nclaude-agents run api-developer --task \"Implement user endpoints from feature-auth-prp.md\"\nclaude-agents run api-developer --task \"Create REST API following our conventions\"\n\n# Frontend Development\nclaude-agents run frontend-developer --task \"Build login UI matching dark-theme-ui-prp\"\nclaude-agents run frontend-developer --task \"Create dashboard from feature-dashboard-prp.md\"\n\n# Testing \u0026 Quality\nclaude-agents run tdd-specialist --task \"Create tests for authentication flow\"\nclaude-agents run code-reviewer --task \"Review API endpoints for security\"\nclaude-agents run security-scanner --task \"Scan authentication implementation\"\n\n# Documentation\nclaude-agents run api-documenter --task \"Generate OpenAPI spec from implemented endpoints\"\nclaude-agents run doc-writer --task \"Update Implementation.md with progress\"\n\n# Debugging \u0026 Refactoring\nclaude-agents run debugger --task \"Analyze login timeout issue\"\nclaude-agents run refactor --task \"Improve error handling in auth module\"\n\n# DevOps \u0026 Deployment\nclaude-agents run devops-engineer --task \"Setup CI/CD for main branch\"\nclaude-agents run devops-engineer --task \"Create Docker configuration\"\n\n# Product \u0026 Marketing\nclaude-agents run product-manager --task \"Create user stories from PRPs\"\nclaude-agents run marketing-writer --task \"Write feature announcement for auth system\"\n```\n\n### Using in Claude Code\n```bash\n# Via slash commands (in .claude/commands/agents/)\n\u003e /agent-review            # Triggers code review\n\u003e /agent-api              # Triggers API development\n\u003e /agent-debug login issue # Debug specific problem\n\n# Via Task tool\n\u003e Task(\"project-planner: analyze all PRPs and create sprint plan\")\n\u003e Task(\"api-developer: implement endpoints from feature-auth-prp.md\")\n\u003e Task(\"frontend-developer: build UI from feature-dashboard-prp.md\")\n```\n\n## 📋 Available Sub-Agents\n\n| Agent Name | Description | Slash Command |\n|------------|-------------|---------------|\n| **code-reviewer** | Expert code review specialist for quality, security, and maintainability | `/review` |\n| **test-runner** | Automated test execution specialist that runs tests and fixes failures | `/test [pattern]` |\n| **debugger** | Expert debugging specialist for analyzing errors, stack traces, and fixing issues | `/debug [error]` |\n| **refactor** | Code refactoring specialist for improving code structure, patterns, and maintainability | `/refactor [target]` |\n| **doc-writer** | Documentation specialist for creating and updating technical documentation, API docs, and README files | `/document [type]` |\n| **security-scanner** | Security vulnerability scanner that detects common security issues and suggests fixes | `/security-scan [path]` |\n| **shadcn-ui-builder** | UI/UX specialist for designing and implementing interfaces using ShadCN UI components | `/ui` or `/shadcn` |\n| **project-planner** | Strategic planning specialist for project decomposition and workflow management | `/plan [project]` |\n| **api-developer** | Backend API development specialist for REST, GraphQL, and microservices | `/api [spec]` |\n| **frontend-developer** | Frontend development specialist for modern web applications | `/frontend [feature]` |\n| **tdd-specialist** | Test-Driven Development specialist for comprehensive testing strategies | `/tdd [component]` |\n| **api-documenter** | API documentation specialist for OpenAPI, Swagger, and technical docs | `/apidoc [endpoint]` |\n| **devops-engineer** | DevOps specialist for CI/CD, infrastructure automation, and deployment | `/devops [task]` |\n| **product-manager** | Product management specialist for requirements, roadmaps, and user stories | `/product [feature]` |\n| **marketing-writer** | Marketing content specialist for technical marketing and product messaging | `/marketing [content]` |\n\n## 🤖 Detailed Agent Descriptions\n\n### 🔍 Code Reviewer\n*Your personal code quality guardian*\n\n- Comprehensive security analysis\n- Best practices enforcement\n- Performance optimization suggestions\n- Clean code principles\n\n```bash\n# Install\nclaude-agents install code-reviewer\n\n# Use\n\u003e /review\n```\n\n### 🧪 Test Runner\n*Intelligent test automation specialist*\n\n- Auto-detects test frameworks\n- Fixes failing tests automatically\n- Improves test coverage\n- Supports all major languages\n\n```bash\n# Install\nclaude-agents install test-runner\n\n# Use\n\u003e /test\n\u003e /test src/**/*.test.js\n```\n\n### 🐛 Debugger\n*Expert problem solver and bug hunter*\n\n- Root cause analysis\n- Stack trace interpretation\n- Performance profiling\n- Memory leak detection\n\n```bash\n# Install\nclaude-agents install debugger\n\n# Use\n\u003e /debug Cannot read property 'map' of undefined\n```\n\n### 🔧 Refactor Assistant\n*Code transformation specialist*\n\n- Apply design patterns\n- Modernize legacy code\n- Improve code structure\n- Maintain functionality\n\n```bash\n# Install\nclaude-agents install refactor\n\n# Use\n\u003e /refactor improve performance\n\u003e /refactor apply SOLID principles\n```\n\n### 📝 Documentation Writer\n*Technical writing expert*\n\n- API documentation\n- README generation\n- Architecture docs\n- Code comments\n\n```bash\n# Install\nclaude-agents install doc-writer\n\n# Use\n\u003e /document API\n\u003e /document architecture\n```\n\n### 🔒 Security Scanner\n*Vulnerability detection specialist*\n\n- Secret detection\n- OWASP compliance\n- Dependency auditing\n- Security best practices\n\n```bash\n# Install\nclaude-agents install security-scanner\n\n# Use\n\u003e /security-scan\n\u003e /security-scan src/api/\n```\n\n### 🎨 ShadCN UI Builder\n*Your expert UI/UX implementation specialist*\n\n- Modern component-based UI development\n- Accessibility-first design approach\n- Responsive interface implementation\n- ShadCN component ecosystem expertise\n- Design system compliance\n\n```bash\n# Install\nclaude-agents install shadcn-ui-builder\n\n# Use\n\u003e /ui create a login page\n\u003e /shadcn implement dashboard with sidebar\n```\n\n### 📋 Project Planner\n*Strategic planning and task decomposition expert*\n\n- Project architecture design\n- Task breakdown and prioritization\n- Dependency mapping\n- Timeline estimation\n- Risk assessment\n\n```bash\n# Install\nclaude-agents install project-planner\n\n# Use\n\u003e /plan e-commerce platform\n\u003e /plan microservices migration\n```\n\n### 🔌 API Developer\n*Backend development specialist*\n\n- RESTful API design\n- GraphQL implementation\n- Microservices architecture\n- Database schema design\n- API security best practices\n\n```bash\n# Install\nclaude-agents install api-developer\n\n# Use\n\u003e /api user authentication endpoints\n\u003e /api payment processing service\n```\n\n### 💻 Frontend Developer\n*Modern web interface specialist*\n\n- React/Vue/Angular expertise\n- Responsive design implementation\n- State management\n- Performance optimization\n- Accessibility compliance\n\n```bash\n# Install\nclaude-agents install frontend-developer\n\n# Use\n\u003e /frontend user dashboard\n\u003e /frontend shopping cart component\n```\n\n### 🧪 TDD Specialist\n*Test-driven development expert*\n\n- Unit test creation\n- Integration testing\n- E2E test scenarios\n- Test coverage analysis\n- Mock and stub implementation\n\n```bash\n# Install\nclaude-agents install tdd-specialist\n\n# Use\n\u003e /tdd UserService class\n\u003e /tdd API integration tests\n```\n\n### 📚 API Documenter\n*Technical documentation specialist*\n\n- OpenAPI/Swagger specs\n- API endpoint documentation\n- Integration guides\n- SDK documentation\n- Example code generation\n\n```bash\n# Install\nclaude-agents install api-documenter\n\n# Use\n\u003e /apidoc REST endpoints\n\u003e /apidoc GraphQL schema\n```\n\n### 🚀 DevOps Engineer\n*Infrastructure and deployment expert*\n\n- CI/CD pipeline setup\n- Docker containerization\n- Kubernetes orchestration\n- Infrastructure as Code\n- Monitoring and logging\n\n```bash\n# Install\nclaude-agents install devops-engineer\n\n# Use\n\u003e /devops GitHub Actions workflow\n\u003e /devops Kubernetes deployment\n```\n\n### 📊 Product Manager\n*Product strategy and planning specialist*\n\n- User story creation\n- Feature specification\n- Roadmap planning\n- Requirements documentation\n- Stakeholder communication\n\n```bash\n# Install\nclaude-agents install product-manager\n\n# Use\n\u003e /product user onboarding flow\n\u003e /product feature prioritization\n```\n\n### ✍️ Marketing Writer\n*Technical marketing content expert*\n\n- Product launch materials\n- Technical blog posts\n- Feature announcements\n- Documentation marketing\n- Developer advocacy content\n\n```bash\n# Install\nclaude-agents install marketing-writer\n\n# Use\n\u003e /marketing product launch post\n\u003e /marketing API feature announcement\n\n## 📖 Documentation\n\n### Command Reference\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `init` | Initialize agents in project | `claude-agents init` |\n| `init --respect-context-forge` | Init preserving context-forge | `claude-agents init --respect-context-forge` |\n| `install` | Install agents interactively | `claude-agents install` |\n| `install --all` | Install all available agents | `claude-agents install --all` |\n| `install --project` | Install to project directory | `claude-agents install --project` |\n| `list` | Show all agents | `claude-agents list` |\n| `list --installed` | Show only installed agents | `claude-agents list --installed` |\n| `enable \u003cagent\u003e` | Enable a disabled agent | `claude-agents enable code-reviewer` |\n| `disable \u003cagent\u003e` | Disable an agent | `claude-agents disable test-runner` |\n| `remove \u003cagent\u003e` | Remove specific agent | `claude-agents remove debugger` |\n| `uninstall` | Bulk uninstall with options | `claude-agents uninstall --all --clean` |\n| `info \u003cagent\u003e` | Show agent details | `claude-agents info debugger` |\n| `create` | Create a custom agent | `claude-agents create` |\n| `run \u003cagent\u003e` | Run agent independently | `claude-agents run marketing-writer --task \"write launch post\"` |\n| `dashboard` | Launch web dashboard | `claude-agents dashboard` |\n\n### Independent Agent Execution\n\nRun agents outside of Claude Code for automation and scripting:\n\n```bash\n# Run with inline task\nclaude-agents run marketing-writer --task \"Write launch announcement for v2.0\"\n\n# Run with task file\nclaude-agents run api-developer --file api-spec.md\n\n# Interactive mode\nclaude-agents run tdd-specialist --interactive\n```\n\n### Web Dashboard\n\nMonitor and manage your agents through the web interface:\n\n```bash\n# Start dashboard on port 7842\nclaude-agents dashboard\n\n# Custom port\nclaude-agents dashboard --port 8080\n```\n\nDashboard features:\n- Real-time agent status\n- Task execution history\n- Memory system viewer\n- Performance metrics\n- Quick agent actions\n\n### Creating Custom Agents\n\n#### Interactive Creation\n```bash\nclaude-agents create\n```\n\n#### Manual Creation\nCreate `~/.claude/agents/my-agent.md`:\n\n```markdown\n---\nname: my-agent\ndescription: What this agent does and when to use it\ntools: Read, Edit, Grep, Bash\n---\n\nYou are an expert in [DOMAIN]. Your role is to [PURPOSE].\n\nWhen invoked, you will:\n1. [STEP 1]\n2. [STEP 2]\n3. [STEP 3]\n\nAlways ensure [KEY PRINCIPLE].\n```\n\n### Installation Scopes\n\n**User Scope** (`~/.claude/agents/`)\n- Available in all projects\n- Personal agents\n- Default installation location\n\n**Project Scope** (`.claude/agents/`)\n- Project-specific agents\n- Shared with team via version control\n- Use `--project` flag\n\n### Advanced Configuration\n\n#### State Management\nAgent states are tracked in `.claude-agents.json`:\n\n```json\n{\n  \"installedAgents\": {\n    \"code-reviewer\": {\n      \"version\": \"1.0.0\",\n      \"scope\": \"user\",\n      \"installedAt\": \"2024-01-20T10:00:00Z\"\n    }\n  },\n  \"enabledAgents\": [\"code-reviewer\"],\n  \"disabledAgents\": []\n}\n```\n\n### Hooks System\n\nThe hooks system enables automated workflows and agent coordination. Each agent can define hooks that trigger on specific events.\n\n#### Hook Types\n\n| Hook Type | Description | Trigger |\n|-----------|-------------|---------|\n| `PostToolUse:Edit` | After file edits | Any file modification |\n| `PostToolUse:Write` | After file creation | New file written |\n| `PostToolUse:Bash` | After command execution | Bash commands run |\n| `PreToolUse` | Before any tool use | Tool about to run |\n| `TaskComplete` | After task completion | Agent finishes task |\n| `Stop` | On conversation end | Session terminating |\n\n#### Hook Actions\n\n```json\n{\n  \"PostToolUse:Edit\": {\n    \"condition\": \"file.endsWith('.js')\",\n    \"commands\": [\"npm run lint\", \"npm test\"]\n  },\n  \"TaskComplete\": {\n    \"notify\": \"Task {{task_name}} completed\",\n    \"store\": \"agent:{{agent_name}}:last_task\"\n  }\n}\n```\n\n#### Example: Auto-Review Hook\n\nCreate hooks for automatic code review after edits:\n\n```json\n{\n  \"hooks\": {\n    \"PostToolUse:Edit\": [{\n      \"matcher\": \"\\\\.(js|ts|py)$\",\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"echo 'Consider running /review' \u003e\u00262\"\n      }]\n    }]\n  }\n}\n```\n\n#### Example: Test Runner Hook\n\nAutomatically run tests after code changes:\n\n```json\n{\n  \"PostToolUse:Edit\": {\n    \"condition\": \"file.includes('src/')\",\n    \"commands\": [\"npm test -- --watch=false\"]\n  }\n}\n```\n\n## 🌟 Our Ecosystem\n\nCheck out our other tools for Claude Code:\n\n### 🪝 [Claude Hooks Manager](https://github.com/webdevtodayjason/claude-hooks)\nPowerful hook management system for Claude Code automation\n\n### 🔨 [Context Forge](https://github.com/webdevtodayjason/context-forge)\nOur flagship tool for intelligent context generation and management\n\n## 🤝 Contributing\n\nWe love contributions! Here's how you can help:\n\n1. **Fork** the repository\n2. **Create** your feature branch (`git checkout -b feature/amazing-agent`)\n3. **Commit** your changes (`git commit -m 'Add amazing agent'`)\n4. **Push** to the branch (`git push origin feature/amazing-agent`)\n5. **Open** a Pull Request\n\n### Adding New Agents\n\n1. Create agent structure:\n```\nagents/\n└── your-agent/\n    ├── agent.md       # Agent definition\n    ├── metadata.json  # Agent metadata\n    └── hooks.json     # Optional hooks\n```\n\n2. Add slash command:\n```\ncommands/\n└── your-command.md\n```\n\n3. Submit PR with description\n\n## 🐛 Troubleshooting\n\n### Agent Not Found After Global Install?\n\n```bash\n# Enable debug mode to see where agents are being searched\nDEBUG=claude-agents claude-agents run project-planner --task \"test\"\n\n# Check npm global installation path\nnpm list -g @webdevtoday/claude-agents\n\n# Verify agents are included in the package\nls -la $(npm root -g)/@webdevtoday/claude-agents/agents/\n```\n\n### Agent Not Working?\n\n```bash\n# Check installation\nclaude-agents list\n\n# Verify agent status\nclaude-agents info \u003cagent-name\u003e\n\n# Re-enable if disabled\nclaude-agents enable \u003cagent-name\u003e\n```\n\n### Debug Mode\n\n```bash\n# Run Claude with debug output\nclaude --debug\n\n# Run claude-agents with debug output\nDEBUG=claude-agents claude-agents run \u003cagent\u003e --task \"test\"\n```\n\n### Common Issues\n\n- **Permission denied**: Use `sudo` for global install\n- **Agent not found**: Check spelling and installation\n- **Command not working**: Ensure Claude Code is updated\n- **\"Agent not found\" error**: Enable debug mode to see search paths\n\n## 📊 Release Notes\n\n### Version 1.4.0 (Latest) - Context-Forge Integration\n- 🛠️ **Context-Forge Support**: Full integration with context-forge projects\n- 📦 **Init Command**: One-command setup with `claude-agents init`\n- 🧹 **Uninstall Command**: Bulk removal with cleanup options\n- 🎯 **PRP Awareness**: Agents understand and work with existing PRPs\n- 📁 **Smart Commands**: Organized in `.claude/commands/agents/` to avoid conflicts\n- ⚡ **Concurrent Execution**: CLAUDE.md rules for maximum performance\n- 📝 **Safe Integration**: Appends to CLAUDE.md without overwriting\n- 🔧 **Bug Fixes**: Project scope installation now works correctly\n\n### Version 1.3.1\n- 🐛 Fixed \"agent not found\" error for global installations\n- 📍 Enhanced path resolution for various npm configurations\n- 🔍 Added debug mode with `DEBUG=claude-agents`\n\n### Version 1.3.0\n- 🎯 Context-forge detection utility\n- 🧠 Enhanced agent system with PRP awareness\n- 💾 Memory system integration\n- 📚 Context-aware command templates\n\n### Version 1.2.0\n- 🤖 15 specialized AI agents\n- ⚡ Concurrent execution patterns\n- 💾 Shared memory system\n- 🌐 Web dashboard\n- 🎯 Slash command integration\n\n### Version 1.0.0\n- 🎉 Initial release\n- 6 production-ready agents\n- Interactive CLI interface\n- Custom agent creation\n- Project/user scope support\n- Comprehensive documentation\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## 🙏 Acknowledgments\n\n- Claude Code team at Anthropic\n- Our amazing community of developers\n- All contributors and testers\n\n## 📬 Connect\n\n- 🐛 [Report Issues](https://github.com/webdevtodayjason/sub-agents/issues)\n- 💡 [Request Features](https://github.com/webdevtodayjason/sub-agents/discussions)\n- 🐦 [Follow Updates](https://twitter.com/webdevtodayjason)\n- ⭐ [Star on GitHub](https://github.com/webdevtodayjason/sub-agents)\n\n## 🔍 SEO Keywords \u0026 Use Cases\n\n### Perfect for developers who want to:\n- **Automate code reviews** with AI-powered analysis\n- **Fix failing tests automatically** using intelligent test runners\n- **Debug complex issues** with expert error analysis\n- **Generate documentation** from existing code\n- **Scan for security vulnerabilities** proactively\n- **Refactor legacy code** with modern patterns\n- **Enhance Claude Code** with specialized capabilities\n- **Create custom AI agents** for specific workflows\n\n### Technologies \u0026 Integrations:\n- Works with **Claude Code** by Anthropic\n- Supports all major programming languages\n- Integrates with existing development workflows\n- Compatible with Git, npm, yarn, and more\n- Extensible through custom agent creation\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by [WebDev Today Jason](https://github.com/webdevtodayjason)**\n\n*Building AI-powered developer tools to enhance productivity and code quality*\n\n**Claude Sub-Agents Manager** - Your AI-Powered Development Team in Claude Code\n\n[![Star History Chart](https://api.star-history.com/svg?repos=webdevtodayjason/sub-agents\u0026type=Date)](https://star-history.com/#webdevtodayjason/sub-agents\u0026Date)\n\n\u003c/div\u003e\n","funding_links":[],"categories":["Frameworks \u0026 Tools","Sub Agents","🆕 Latest \u0026 Featured Agent Collections (August 2025)"],"sub_categories":["Agent Management","**Specialized Frameworks \u0026 Tools**"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fsub-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebdevtodayjason%2Fsub-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fsub-agents/lists"}