Visión general de la CLI

La CLI suya es la interfaz principal a Subaya, tanto para personas como para agentes de IA y CI. Todo lo que puedes hacer a través de la plataforma comienza aquí; la consola web en subaya-dev.com es para resultados, formas de onda, informes y revisión. Consulta Conceptos básicos para el modelo mental y el Inicio rápido para pasar de la instalación a una simulación exitosa.

Indicadores globales

Estos indicadores funcionan en todos los comandos:

Indicador	Descripción
--host <url>	Host de la API de destino. Por defecto, https://subaya-dev.com.
--token <token>	Usa un token de autenticación explícito para esta invocación.
--json	Emite salida JSON legible por máquina.
--pretty	Da formato legible a la salida para personas.
-q, --quiet	Suprime la salida no esencial.
-v, --verbose	Imprime detalle de diagnóstico adicional.

--json combina bien con agentes y CI; --pretty es el valor predeterminado amigable para una terminal.

Configuración de proyecto — .subaya/config.toml

La mayoría de los comandos con alcance de proyecto leen su --project predeterminado de un archivo local .subaya/config.toml. Una vez que un proyecto se inicializa en un directorio (consulta suya project), comandos como suya project show, suya sim run y suya repo status operan sobre ese proyecto sin que pases --project cada vez. Pasa --project <project-id> explícitamente para anularlo.

Autenticación

Dos modos resuelven contra la misma API; todos los detalles en Autenticación y claves de API y la referencia suya auth:

• SUBAYA_API_KEY — una variable de entorno para agentes y CI. Sin navegador.
• suya auth login — flujo de OAuth en el navegador para desarrolladores humanos.

export SUBAYA_API_KEY="sk_..."
suya auth whoami

Grupos de comandos

Grupo	Qué hace
suya auth	Inicia sesión, cierra sesión e inspecciona tu identidad.
suya project	Crea, enumera y gestiona proyectos y fases.
suya sim	Ejecuta simulaciones en la nube e inspecciona resultados.
suya hw	Ejecuciones de validación de hardware y gestión de agentes (BitCrucible).
suya rag	Busca y lee la base de conocimiento.
suya plan	Documentos de planificación, elementos de trabajo y diagramas.
suya repo	Crea o conecta un repositorio de GitHub para un proyecto.
suya device	Explora el catálogo de dispositivos y asigna un dispositivo.
Sesión	suya attach / suya detach de tu pod de sesión.

Más grupos de comandos

Estos grupos completan la superficie:

• suya arch — arquitectura y planificación de pines embebidos (módulos, planes de pines, configuración de periféricos/relojes, validate, generate, confirmación de .ioc).
• suya req — añade y enumera los requisitos de un proyecto (suya req add, suya req list).
• suya review — revisiones de código y de diseño (create, show, list, comment, reply, resolve, approve y más).
• suya diagram — crea y renderiza diagramas Mermaid a SVG/PNG (create, update, show, list, export, render, delete).

Comandos de nivel superior

Comando	Descripción
suya version	Imprime los metadatos de versión.
suya update [--check]	Actualiza a la última versión; --check solo informa de la disponibilidad.
suya install [--skills] [--path <p>] [--force]	Instala las integraciones de Subaya (suya-cli + paquetes de skills del planificador).
suya completion <shell>	Imprime el autocompletado del shell para el shell indicado.