Referencia CLI

Referencia completa de la herramienta de línea de comandos squads.

npm install -g squads

squads add <sources...>

Instala squads en tu proyecto desde múltiples fuentes simultáneamente — repositorios de GitHub, directorios locales o el registro squads.sh. Los squads se descargan, validan y colocan en el directorio de squads de tu proyecto.

Uso
squads add <sources...> [options]
Opciones
--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)
Ejemplos

Install from GitHub

squads add owner/repo

Install from local directory

squads add ./my-squad

Install from registry

squads add design-system

Install multiple squads at once

squads add slug1 slug2 slug3

Install into a new AIOS project

squads add my-squad --aios new

Install into an existing AIOS project

squads add my-squad --aios existing

Install a specific agent

squads add my-squad --agent designer

squads find [query]

Busca squads en el marketplace por palabra clave. Devuelve una lista de squads coincidentes con conteo de instalaciones y puntuaciones.

Uso
squads find [query] [options]
Opciones
-l, --limit <n>Maximum number of results (default: 20)
Ejemplos

Search by keyword

squads find "design system"

List all squads

squads find

squads list (ls)

Lista todos los squads instalados en el proyecto actual. Muestra nombre, versión, cantidad de agentes y ruta de instalación.

Uso
squads list [options]
Opciones
-g, --globalList globally installed squads
Ejemplos

List installed squads

squads list

List globally installed squads

squads list --global

squads check

Valida todos los squads instalados. Comprueba la integridad estructural, archivos faltantes y referencias cruzadas rotas.

Uso
squads check
Ejemplos

Check installed squads

squads check

squads update [squad]

Actualiza uno o todos los squads instalados a su última versión. Sin nombre de squad, actualiza todos.

Uso
squads update [squad] [options]
Opciones
-y, --yesSkip confirmation prompts
Ejemplos

Update all squads

squads update

Update a specific squad

squads update design-system-squad

squads remove (rm) <squad>

Elimina un squad instalado de tu proyecto. Limpia el directorio del squad y cualquier slash command sincronizado.

Uso
squads remove <squad> [options]
Opciones
-y, --yesSkip confirmation prompts
Ejemplos

Remove a squad

squads remove old-squad

Remove without confirmation

squads remove old-squad -y

squads init [name]

Inicializa un nuevo proyecto de squad con scaffolding. Crea la estructura de directorios, squad.yaml y archivos iniciales de agentes/tareas/workflows.

Uso
squads init [name] [options]
Opciones
-y, --yesSkip confirmation prompts and use defaults
Ejemplos

Create a new squad

squads init my-squad

Create with defaults

squads init my-squad -y

squads validate [path]

Ejecuta validación profunda en un directorio de squad. Verifica 6 categorías ponderadas (manifiesto, estructura, agentes, tareas, workflows, referencias cruzadas) y produce una puntuación de 0 a 100.

Uso
squads validate [path] [options]
Opciones
--jsonSalida en formato JSON
--fixAuto-corregir problemas comunes antes de validar
Ejemplos

Validate current directory

squads validate

Validate a specific squad

squads validate ./squads/my-squad

JSON output

squads validate --json

Auto-fix then validate

squads validate --fix

squads fix [path]

Auto-corrige problemas comunes de validación en un squad. Corrige formato frontmatter, archetypes, tipos, tono y greeting levels. Usa --dry-run para previsualizar cambios sin modificar archivos.

Uso
squads fix [path] [options]
Opciones
--dry-runMostrar qué se corregiría sin modificar archivos
Ejemplos

Auto-fix current squad

squads fix

Fix a specific squad

squads fix ./squads/my-squad

Preview fixes

squads fix --dry-run

squads publish [squad-name]

Publica squads en el marketplace squads.sh. Selecciona varios squads a la vez y elige el repositorio destino.

Uso
squads publish [squad-name] [options]
Opciones
--dry-runValida sin publicar
--strictFalla si el estado no es SAFE
--price <cents>Establecer precio en centavos (ej., 2990 para $29.90, 0 para gratis)
Ejemplos

Multi-selección de squads locales

squads publish

Publica un squad por nombre

squads publish my-squad

Publica desde una ruta específica

squads publish ./squads/my-squad

Dry run para validar antes de publicar

squads publish --dry-run

Modo estricto (requiere estado SAFE)

squads publish my-squad --strict

Publicar con precio ($29.90)

squads publish --price 2990

Publicar como gratis

squads publish --price 0

squads login

Autentícate en squads.sh usando GitHub device flow. Requerido antes de publicar squads.

Uso
squads login
Ejemplos

Authenticate via GitHub

squads login
Referencia CLI — SQUADS