Referência CLI
Referência completa da ferramenta de linha de comando squads.
npm install -g squadssquads add <sources...>
Instale squads no seu projeto a partir de múltiplas fontes simultaneamente — repositórios GitHub, diretórios locais ou o registro squads.sh. Os squads são baixados, validados e colocados no diretório de squads do seu projeto.
squads add <sources...> [options]--skill <name>Specify which squad to install when repo has multiple squads-a, --agent <name>Install a specific agent from the squad-g, --globalInstall globally instead of in the current project-y, --yesSkip confirmation prompts--aios <mode>AIOS integration mode: new (create project) or existing (use current)--aios-path <path>Path to the AIOS project (for existing mode)Install from GitHub
squads add owner/repoInstall from local directory
squads add ./my-squadInstall from registry
squads add design-systemInstall multiple squads at once
squads add slug1 slug2 slug3Install into a new AIOS project
squads add my-squad --aios newInstall into an existing AIOS project
squads add my-squad --aios existingInstall a specific agent
squads add my-squad --agent designersquads find [query]
Busque squads no marketplace por palavra-chave. Retorna uma lista de squads correspondentes com contagem de instalações e avaliações.
squads find [query] [options]-l, --limit <n>Maximum number of results (default: 20)Search by keyword
squads find "design system"List all squads
squads findsquads list (ls)
Liste todos os squads instalados no projeto atual. Exibe nome, versão, quantidade de agentes e caminho de instalação.
squads list [options]-g, --globalList globally installed squadsList installed squads
squads listList globally installed squads
squads list --globalsquads check
Valide todos os squads instalados. Verifica integridade estrutural, arquivos ausentes e referências cruzadas quebradas.
squads checkCheck installed squads
squads checksquads update [squad]
Atualize um ou todos os squads instalados para a versão mais recente. Sem nome de squad, atualiza todos.
squads update [squad] [options]-y, --yesSkip confirmation promptsUpdate all squads
squads updateUpdate a specific squad
squads update design-system-squadsquads remove (rm) <squad>
Remova um squad instalado do seu projeto. Limpa o diretório do squad e quaisquer slash commands sincronizados.
squads remove <squad> [options]-y, --yesSkip confirmation promptsRemove a squad
squads remove old-squadRemove without confirmation
squads remove old-squad -ysquads init [name]
Inicialize um novo projeto de squad com scaffolding. Cria a estrutura de diretórios, squad.yaml e arquivos iniciais de agentes/tarefas/workflows.
squads init [name] [options]-y, --yesSkip confirmation prompts and use defaultsCreate a new squad
squads init my-squadCreate with defaults
squads init my-squad -ysquads validate [path]
Executa validação profunda em um diretório de squad. Verifica 6 categorias ponderadas (manifesto, estrutura, agentes, tarefas, workflows, referências cruzadas) e produz uma pontuação de 0 a 100.
squads validate [path] [options]--jsonSaída em formato JSON--fixAuto-corrige problemas comuns antes de validarValidate current directory
squads validateValidate a specific squad
squads validate ./squads/my-squadJSON output
squads validate --jsonAuto-fix then validate
squads validate --fixsquads fix [path]
Auto-corrige problemas comuns de validação em um squad. Corrige formato de frontmatter, archetypes, types, tone e greeting levels. Use --dry-run para pré-visualizar sem modificar arquivos.
squads fix [path] [options]--dry-runMostra o que seria corrigido sem modificar arquivosAuto-fix current squad
squads fixFix a specific squad
squads fix ./squads/my-squadPreview fixes
squads fix --dry-runsquads publish [squad-name]
Publica squads no marketplace squads.sh. Selecione vários squads e escolha o repositório destino.
squads publish [squad-name] [options]--dry-runValida sem publicar--strictFalha se o status não for SAFE--price <cents>Define preço em centavos (ex: 2990 para $29.90, 0 para gratuito)Multi-seleção de squads locais
squads publishPublica um squad pelo nome
squads publish my-squadPublica de um caminho específico
squads publish ./squads/my-squadDry run para validar antes de publicar
squads publish --dry-runModo estrito (requer status SAFE)
squads publish my-squad --strictPublicar com preço ($29.90)
squads publish --price 2990Publicar como gratuito
squads publish --price 0squads login
Autentique-se no squads.sh usando GitHub device flow. Necessário antes de publicar squads.
squads loginAuthenticate via GitHub
squads login