Documentation

What is squads.sh?

squads.sh is the gamified marketplace for AIOS Squads. It is a platform where developers and AI engineers can discover, share, install, 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 dropped into any AIOS-compatible project.

What are AIOS Squads?

An AIOS 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-sh/cli

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/my-awesome-squad

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.