Documentación

¿Qué es squads.sh?

squads.sh es el marketplace gamificado para AI agent squads. Es una plataforma donde desarrolladores e ingenieros de IA pueden descubrir, compartir, instalar y publicar squads de agentes IA reutilizables. Piensa en ello como npm para equipos de agentes IA — cada squad es un paquete autónomo de agentes, tareas, workflows y configuración que puede integrarse en cualquier proyecto compatible con Squad.

¿Qué es Nirvana-OS?

Nirvana-OS es un framework para el desarrollo de software orquestado por IA. En lugar de tratar la IA como un simple autocompletado, organiza agentes especializados en squads — equipos de agentes IA que trabajan juntos con roles, tareas y workflows definidos. Soporta múltiples IDEs (Claude Code, Gemini CLI, Codex CLI, Cursor) y sigue una filosofía CLI-first.

npx @nirvana-os/cli

Instálalo con npx @nirvana-os/cli

¿Qué son los AI agent squads?

Un Squad es una colección estructurada de agentes IA diseñados para trabajar juntos en un dominio o tarea específica. Cada squad incluye:

• ▸Agentes — Personalidades de IA especializadas con roles definidos, estilos de comunicación y capacidades.
• ▸Tareas — Unidades atómicas de trabajo con contratos de entrada/salida, checklists y responsabilidades asignadas.
• ▸Workflows — Patrones de orquestación que definen cómo colaboran los agentes, con transiciones e indicadores de éxito.
• ▸Configuración — Estándares de código, definiciones de stack tecnológico y mapas de estructura del proyecto.

Primeros pasos

Instala el CLI globalmente para empezar a usar squads en tus proyectos:

npm install -g squads

1. Buscar squads

Explora el marketplace o busca por palabra clave:

squads find "design system"

2. Instalar un squad

Añade un squad a tu proyecto desde un repositorio de GitHub o el marketplace:

squads add user/repo/my-awesome-squad

2b. Instalar con activación Nirvana-OS

Para una integración completa con tu IDE mediante slash commands, activa el squad con Nirvana-OS:

npx @nirvana-os/cli

squads add my-squad

Tras la activación, los agentes del squad se registran como slash commands del IDE siguiendo el patrón /SQUADS:.

/SQUADS:prefix:agent-id

3. Verificar la instalación

Comprueba que todos los squads son válidos y están actualizados:

squads check

Cómo publicar

Comparte tu squad con la comunidad. Autentícate con GitHub y luego publica:

squads login

squads publish ./my-squad

Tu squad pasará por una auditoría de seguridad antes de aparecer en el marketplace. Puedes seguir el estado de la auditoría en la página de Auditorías.

También puedes publicar squads directamente desde la interfaz web. Dashboard > Submit

Publicar con precio

Puedes vender tu squad en el marketplace. Establece un precio en centavos USD al publicar:

squads publish --price 2990

squads publish --price 0

El precio debe estar entre $0.99 y $999.99. Necesitas conectar tu cuenta de Stripe en Configuración antes de vender squads de pago.

Vender Squads

squads.sh soporta squads de pago con distribución protegida por servidor. Cuando un squad es de pago:

• ▸El código fuente se almacena de forma segura en los servidores de squads.sh (no público en GitHub).
• ▸Los compradores deben comprar vía Stripe antes de poder instalar.
• ▸Los ingresos se dividen 80% para el vendedor y 20% para la plataforma.
• ▸Los vendedores deben conectar su cuenta de Stripe en Dashboard > Configuración.

Comprar un squad

Cuando intentas instalar un squad de pago que no has comprado, el CLI mostrará el precio y un enlace para comprarlo en squads.sh. Después de la compra, ejecuta el comando de instalación de nuevo.

Integración Nirvana-OS

Los squads se ejecutan sobre Nirvana-OS — el núcleo de orquestación que convierte una carpeta de agentes, tareas y workflows en un equipo de IA funcional.

Una vez instalado con Nirvana-OS, cada agente está disponible como un slash command.

Instala Nirvana-OS para empezar:

npx @nirvana-os/cli

Más información sobre Nirvana-OS