Documentation

What is squads.sh?

squads.sh is the gamified marketplace for AI agent squads. It is a platform where developers and AI engineers can discover, share, install, buy, sell, and publish reusable AI agent squads. Think of it as npm for AI agent teams — each squad is a self-contained package of agents, tasks, workflows, and configuration that can be used in any project.

docs.whatIsAiosTitle

docs.whatIsAiosDescription

docs.whatIsAiosLink

What are Squads?

A Squad is a structured collection of AI agents designed to work together on a specific domain or task. Each squad includes:

• ▸Agents — Specialized AI personas with defined roles, communication styles, and capabilities.
• ▸Tasks — Atomic units of work with input/output contracts, checklists, and assigned responsibilities.
• ▸Workflows — Orchestration patterns that define how agents collaborate, with transitions and success indicators.
• ▸Configuration — Coding standards, tech stack definitions, and project structure maps.

Getting Started

Install the CLI globally to start using squads in your projects:

npm install -g squads

1. Search for squads

Browse the marketplace or search by keyword:

squads find "design system"

2. Install a squad

Add a squad to your project from a GitHub repository or the marketplace:

squads add user/repo/my-awesome-squad

docs.step2AiosTitle

docs.step2AiosDescription

squads add my-squad --aios new

squads add my-squad --aios existing

docs.step2AiosResult

/SQUADS:prefix:agent-id

3. Verify your installation

Check that all squads are valid and up to date:

squads check

How to Publish

Share your squad with the community. Authenticate with GitHub, then publish:

squads login

squads publish ./my-squad

Your squad will undergo a security audit before being listed on the marketplace. You can track the audit status on the Audits page.

You can also publish squads directly from the web interface. Dashboard > Submit

Publishing with a price

You can sell your squad on the marketplace. Set a price in USD cents when publishing:

squads publish --price 2990

squads publish --price 0

The price must be between $0.99 and $999.99. You need to connect your Stripe account in Settings before selling paid squads.

Selling Squads

squads.sh supports paid squads with server-gated distribution. When a squad is paid:

• ▸The source code is stored securely on squads.sh servers (not public on GitHub).
• ▸Buyers must purchase via Stripe before they can install.
• ▸Revenue is split 80% to the seller and 20% to the platform.
• ▸Sellers must connect their Stripe account in Dashboard > Settings.

Buying a squad

When you try to install a paid squad you haven't purchased, the CLI will show the price and a link to buy it on squads.sh. After purchasing, run the install command again.

docs.aiosTitle

docs.aiosDescription

docs.aiosSlashCommands

docs.aiosInstallCore

npx aios-core init

docs.aiosLearnMore