README.md

February 2, 2026 · View on GitHub

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

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

See CONTRIBUTING.md for detailed guidelines.

License

MIT License - see LICENSE for details.

Built by augmnt