subagents.sh

A marketplace for Claude Code sub-agents - Discover, share, and enhance your development workflow with specialized AI sub-agents for Claude Code.

🌐 Live Site: subagents.sh

✨ Features

• 🔍 Browse & Search - Discover sub-agents by category, language, and functionality
• 🚀 GitHub Integration - Import sub-agents directly from GitHub repositories
• 👤 User Profiles - Manage your sub-agents and collections
• ⭐ Reviews & Ratings - Community-driven quality assessment
• 📱 Responsive Design - Works seamlessly on desktop and mobile
• 🌙 Dark Mode - Modern UI with light/dark theme support
• 🔐 Secure Authentication - GitHub OAuth integration

🛠️ Tech Stack

• Framework: Next.js 14 with App Router
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: shadcn/ui
• Database: Supabase (PostgreSQL)
• Authentication: Supabase Auth with GitHub OAuth
• Deployment: Vercel

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• Supabase CLI (for database development)

Installation

1. Clone the repository

   git clone https://github.com/augmnt/subagents.sh.git
   cd subagents.sh

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env.local

   Edit .env.local with your Supabase credentials:

   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
   SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
   GITHUB_TOKEN=your_github_token

4. Set up the database

   npm run db:setup
   npm run db:start

5. Start the development server

   npm run dev

   Open http://localhost:3000 to see the application.

📚 Scripts

# Development
npm run dev              # Start development server
npm run build           # Build for production
npm run start           # Start production server

# Database
npm run db:setup        # Set up Supabase locally
npm run db:start        # Start Supabase
npm run db:stop         # Stop Supabase
npm run db:reset        # Reset database
npm run db:types        # Generate TypeScript types

# Testing
npm run test            # Run unit tests
npm run test:e2e        # Run end-to-end tests
npm run test:all        # Run all tests

# Code Quality
npm run lint            # Lint code
npm run lint:fix        # Fix linting issues
npm run format          # Format code
npm run type-check      # Type checking

🤝 Contributing

We welcome contributions from the community! Please see our Contributing Guide for details on how to get started.

Quick Contribution Steps

1. Fork the repository
2. Create a feature branch: git checkout -b feat/amazing-feature
3. Make your changes and add tests
4. Commit using conventional commits: git commit -m "feat: add amazing feature"
5. Push to your fork: git push origin feat/amazing-feature
6. Create a Pull Request

📋 Code of Conduct

We are committed to providing a friendly, safe, and welcoming environment for all contributors. By participating in this project, you agree to abide by our simple code of conduct:

• Be respectful - Treat everyone with respect and kindness
• Be inclusive - Welcome people of all backgrounds and experience levels
• Be constructive - Focus on what's best for the community
• Be professional - Keep discussions focused and productive

For more details, see our Code of Conduct.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• Website: subagents.sh
• GitHub: github.com/augmnt/subagents.sh
• Issues: Report bugs or request features
• Discussions: Join the conversation

🙏 Acknowledgments

• Claude Code - The AI-powered development environment
• Anthropic - For creating Claude
• Vercel - For hosting and deployment
• Supabase - For backend infrastructure
• All our contributors

---

Made with ❤️ by the augmnt team

⭐ Star this repo if you find it useful!