Documentação

O que é squads.sh?

squads.sh é o marketplace gamificado para AI agent squads. É uma plataforma onde desenvolvedores e engenheiros de IA podem descobrir, compartilhar, instalar, comprar, vender e publicar squads de agentes IA reutilizáveis. Pense nele como o npm para equipes de agentes IA — cada squad é um pacote autônomo de agentes, tarefas, workflows e configuração que pode ser integrado a qualquer projeto compatível com Squad.

O que é Nirvana-OS?

Nirvana-OS é um framework para desenvolvimento de software orquestrado por IA. Em vez de tratar a IA como um simples autocomplete, ele organiza agentes especializados em squads — equipes de agentes IA que trabalham juntos com papéis, tarefas e workflows definidos. Suporta múltiplas IDEs (Claude Code, Gemini CLI, Codex CLI, Cursor) e segue uma filosofia CLI-first.

npx @nirvana-os/cli

Instale com npx @nirvana-os/cli

O que são AI agent squads?

Um Squad é uma coleção estruturada de agentes IA projetados para trabalhar juntos em um domínio ou tarefa específica. Cada squad inclui:

• ▸Agentes — Personas de IA especializadas com papéis definidos, estilos de comunicação e capacidades.
• ▸Tarefas — Unidades atômicas de trabalho com contratos de entrada/saída, checklists e responsabilidades atribuídas.
• ▸Workflows — Padrões de orquestração que definem como os agentes colaboram, com transições e indicadores de sucesso.
• ▸Configuração — Padrões de código, definições de stack tecnológica e mapas de estrutura do projeto.

Primeiros passos

Instale o CLI globalmente para começar a usar squads nos seus projetos:

npm install -g squads

1. Buscar squads

Navegue pelo marketplace ou busque por palavra-chave:

squads find "design system"

2. Instalar um squad

Adicione um squad ao seu projeto a partir de um repositório do GitHub ou do marketplace:

squads add user/repo/my-awesome-squad

2b. Instalar com ativação Nirvana-OS

Para integração completa com a IDE via slash commands, ative o squad com o Nirvana-OS:

npx @nirvana-os/cli

squads add my-squad

Após a ativação, os agentes do squad são registrados como slash commands da IDE seguindo o padrão /SQUADS:.

/SQUADS:prefix:agent-id

3. Verificar a instalação

Confira se todos os squads são válidos e estão atualizados:

squads check

Como publicar

Compartilhe seu squad com a comunidade. Autentique-se com o GitHub e depois publique:

squads login

squads publish ./my-squad

Seu squad passará por uma auditoria de segurança antes de ser listado no marketplace. Você pode acompanhar o status da auditoria na página de Auditorias.

Você também pode publicar squads diretamente pela interface web. Dashboard > Submit

Publicar com preço

Você pode vender seu squad no marketplace. Defina um preço em centavos USD ao publicar:

squads publish --price 2990

squads publish --price 0

O preço deve ser entre $0.99 e $999.99. Você precisa conectar sua conta Stripe em Configurações antes de vender squads pagos.

Vendendo Squads

squads.sh suporta squads pagos com distribuição server-gated. Quando um squad é pago:

• ▸O código-fonte é armazenado com segurança nos servidores do squads.sh (não público no GitHub).
• ▸Compradores devem adquirir via Stripe antes de instalar.
• ▸A receita é dividida em 80% para o vendedor e 20% para a plataforma.
• ▸Vendedores devem conectar sua conta Stripe em Dashboard > Configurações.

Comprando um squad

Quando você tenta instalar um squad pago que não comprou, o CLI mostra o preço e um link para comprá-lo no squads.sh. Após a compra, execute o comando de instalação novamente.

Integração Nirvana-OS

Squads rodam no Nirvana-OS — o núcleo de orquestração que transforma uma pasta de agentes, tarefas e workflows em uma equipe de IA funcional.

Uma vez instalado com o Nirvana-OS, cada agente fica disponível como um slash command.

Instale o Nirvana-OS para começar:

npx @nirvana-os/cli

Saiba mais sobre o Nirvana-OS