A discovery platform for Claude Code sub-agents. Browse, install, and share specialized AI agents that enhance your development workflow.

subagents.sh

---

Quick Start

Install any subagent with a single command:

npx @augmnt-sh/subagents add owner/repo/agent-name

The agent is saved to .claude/agents/ and automatically used by Claude Code when relevant.

CLI Reference

Command	Description
npx @augmnt-sh/subagents add owner/repo/name	Install a subagent
npx @augmnt-sh/subagents list	List installed subagents
npx @augmnt-sh/subagents remove name	Remove a subagent
npx @augmnt-sh/subagents update	Update all subagents

---

Publishing Subagents

Create a markdown file with YAML frontmatter:

---
name: my-agent
description: What this agent does
tools:
  - Read
  - Write
  - Bash
---

Your agent instructions here...

Host it on GitHub in one of these locations:

• .claude/agents/ (recommended)
• agents/
• Repository root

Users install directly from your repo:

npx @augmnt-sh/subagents add your-username/your-repo/agent-name

Your agent appears on the leaderboard as people install it.

Frontmatter Fields

Field	Required	Description
name	Yes	Agent identifier
description	No	Brief description for listings
tools	No	Claude Code tools the agent uses

---

Development

Prerequisites

• Node.js 18+
• Supabase CLI

Setup

git clone https://github.com/augmnt/subagents.sh.git
cd subagents.sh
npm install
cp .env.example .env.local
# Edit .env.local with your credentials
npm run dev

Environment Variables

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

Scripts

Script	Description
npm run dev	Start development server
npm run build	Build for production
npm run test	Run tests
npm run lint	Lint code

Tech Stack

• Next.js 14 - React framework
• TypeScript - Type safety
• Tailwind CSS - Styling
• shadcn/ui - UI components
• Supabase - Database & auth
• Vercel - Deployment

---

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feat/my-feature
3. Commit changes: git commit -m "feat: add my feature"
4. Push to your fork: git push origin feat/my-feature
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

---

License

MIT License - see LICENSE for details.

---

Built by augmnt