Supercharge opencode with a team of specialized AI agents that work together to build complete features, debug complex issues, and handle any technology stack with expert-level knowledge.
- opencode CLI installed and authenticated
- Claude subscription - required for intensive agent workflows
- Active project directory with your codebase
- Optional: Context7 MCP for enhanced documentation access
git clone https://github.com/maclevison/awesome-opencode-agents.gitmacOS/Linux:
# Create agents directory if it doesn't exist (preserves existing agents)
mkdir -p ~/.config/opencode/agents
# Symlink the awesome-opencode-agents collection
ln -sf "$(pwd)/awesome-opencode-agents/agents/" ~/.config/opencode/agents/awesome-opencode-agentsWindows (PowerShell):
# Create agents directory
New-Item -Path "$env:USERPROFILE\.config\opencode\agents" -ItemType Directory -Force
# Create symlink
cmd /c mklink /D "$env:USERPROFILE\.config\opencode\agents\awesome-opencode-agents" "$(Get-Location)\awesome-opencode-agents\agents"# Create agents directory if it doesn't exist
mkdir -p ~/.config/opencode/agents
# Copy all agents
cp -r awesome-opencode-agents/agents ~/.config/opencode/agents/awesome-opencode-agentsopencode /agents
# Should show all 36 agents.Navigate to your project directory and run the following command to configure your AI team:
opencode "use @agent-team-configurator and optimize my project to best use the available subagents."opencode "use @agent-tech-lead-orchestrator and build a user authentication system"Your AI team will automatically detect your stack and use the right specialists!
The @agent-team-configurator automatically sets up your perfect AI development team. When invoked, it:
- Locates AGENTS.md - Finds existing project configuration and preserves all your custom content outside the "AI Team Configuration" section
- Detects Technology Stack - Inspects package.json, composer.json, requirements.txt, go.mod, Gemfile, and build configs to understand your project
- Discovers Available Agents - Scans ~/.config/opencode/agents/ and .opencode/agents/ folders, building a capability table of all available specialists
- Selects Specialists - Prefers framework-specific agents over universal ones, always includes @agent-code-reviewer and @agent-performance-optimizer for quality assurance
- Updates AGENTS.md - Creates a timestamped "AI Team Configuration" section with your detected stack and a Task|Agent|Notes mapping table
- Provides Usage Guidance - Shows you the detected stack, selected agents, and gives sample commands to start building
- Tech Lead Orchestrator - Senior technical lead who analyzes complex projects and coordinates multi-step development tasks
- Project Analyst - Technology stack detection specialist who enables intelligent agent routing
- Team Configurator - AI team setup expert who detects your stack and configures optimal agent mappings
- Laravel (2 agents)
- Backend Expert - Comprehensive Laravel development with MVC, services, and Eloquent patterns
- Eloquent Expert - Advanced ORM optimization, complex queries, and database performance
- Django (3 agents)
- Backend Expert - Models, views, services following current Django conventions
- API Developer - Django REST Framework and GraphQL implementations
- ORM Expert - Query optimization and database performance for Django applications
- Rails (3 agents)
- Backend Expert - Full-stack Rails development following conventions
- API Developer - RESTful APIs and GraphQL with Rails patterns
- ActiveRecord Expert - Complex queries and database optimization
- React (2 agents)
- Component Architect - Modern React patterns, hooks, and component design
- Next.js Expert - SSR, SSG, ISR, and full-stack Next.js applications
- Vue (3 agents)
- Component Architect - Vue 3 Composition API and component patterns
- Nuxt Expert - SSR, SSG, and full-stack Nuxt applications
- State Manager - Pinia and Vuex state architecture
- Astro (3 agents)
- Frontend Expert - Islands Architecture, View Transitions, and high-performance static sites
- Component Architect - .astro component design, props, slots, and reusable UI architecture
- Content Collections Expert - Content Collections, Actions, and Astro DB for type-safe content management
- Python (9 agents)
- Python Expert - Modern Python 3.12+ development, project architecture, and best practices
- FastAPI Expert - High-performance APIs with FastAPI 0.115+, Pydantic V2, and async patterns
- Django Expert - Full-stack Django 5.0+ development, DRF, and scalable architecture
- ML/Data Expert - Machine Learning, data science, TensorFlow, PyTorch, and pandas
- Security Expert - Python security, cryptography, and vulnerability assessment
- Testing Expert - Comprehensive testing strategies with pytest and test automation
- Performance Expert - Profiling, optimization, and concurrent programming
- Web Scraping Expert - Web scraping, data extraction, and async crawling
- DevOps/CI-CD Expert - Deployment automation, containerization, and infrastructure as code
- Backend Developer - Polyglot backend development across multiple languages and frameworks
- Frontend Developer - Modern web technologies and responsive design for any framework
- API Architect - RESTful design, GraphQL, and framework-agnostic API architecture
- Tailwind Frontend Expert - Tailwind CSS styling, utility-first development, and responsive components
- Code Archaeologist - Explores, documents, and analyzes unfamiliar or legacy codebases
- Code Reviewer - Rigorous security-aware reviews with severity-tagged reports
- Performance Optimizer - Identifies bottlenecks and applies optimizations for scalable systems
- Documentation Specialist - Crafts comprehensive READMEs, API specs, and technical documentation
Total: 36 specialized agents working together to build your projects!
- Specialized Expertise: Each agent masters their domain with deep, current knowledge
- Real Collaboration: Agents coordinate seamlessly, sharing context and handing off tasks
- Tailored Solutions: Get code that matches your exact stack and follows its best practices
- Parallel Execution: Multiple specialists work simultaneously for faster delivery
- Ship Faster - Complete features in minutes, not days
- Better Code Quality - Every line follows best practices
- Learn As You Code - See how experts approach problems
- Scale Confidently - Architecture designed for growth
- Creating Custom Agents - Build specialists for your needs
- Best Practices - Get the most from your AI team
- ⭐ Star this repo to show support
- 🐛 Report issues
- 💡 Share ideas
- 🎉 Success stories
MIT License - Use freely in your projects!
Transform opencode into an AI development team that ships production-ready features
Simple setup. Powerful results. Just describe and build.