Visão geral da CLI

A CLI suya é a interface primária para o Subaya — tanto para humanos quanto para agentes de IA e CI. Tudo o que você pode fazer pela plataforma começa aqui; o console web em subaya-dev.com é para resultados, waveforms, relatórios e revisão. Veja Conceitos centrais para o modelo mental e o Início rápido para ir da instalação a uma simulação aprovada.

Flags globais

Estas flags funcionam em todos os comandos:

Flag	Descrição
--host <url>	Host de API alvo. Padrão https://subaya-dev.com.
--token <token>	Usa um token de autenticação explícito para esta invocação.
--json	Emite saída JSON legível por máquina.
--pretty	Formata a saída de forma agradável para humanos.
-q, --quiet	Suprime saída não essencial.
-v, --verbose	Imprime detalhes de diagnóstico extras.

--json combina bem com agentes e CI; --pretty é o padrão amigável para um terminal.

Configuração de projeto — .subaya/config.toml

A maioria dos comandos com escopo de projeto lê seu valor padrão de --project de um arquivo .subaya/config.toml local. Uma vez que um projeto é inicializado em um diretório (veja suya project), comandos como suya project show, suya sim run e suya repo status operam sobre aquele projeto sem que você passe --project toda vez. Passe --project <project-id> explicitamente para sobrescrever.

Autenticação

Dois modos resolvem contra a mesma API — detalhes completos em Autenticação e chaves de API e na referência suya auth:

• SUBAYA_API_KEY — uma variável de ambiente para agentes e CI. Sem navegador.
• suya auth login — fluxo OAuth de navegador para desenvolvedores humanos.

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

Grupos de comandos

Grupo	O que faz
suya auth	Faça login, logout e inspecione sua identidade.
suya project	Crie, liste e gerencie projetos e fases.
suya sim	Execute simulações na nuvem e inspecione resultados.
suya hw	Execuções de validação de hardware e gerenciamento de agentes (BitCrucible).
suya rag	Pesquise e leia a base de conhecimento.
suya plan	Documentos de planejamento, itens de trabalho e diagramas.
suya repo	Crie ou conecte um repositório GitHub para um projeto.
suya device	Navegue pelo catálogo de dispositivos e atribua um dispositivo.
Session	suya attach / suya detach no seu session pod.

Mais grupos de comandos

Estes grupos completam a superfície:

• suya arch — arquitetura e planejamento de pinos embarcado (módulos, pin-plans, configuração de periférico/clock, validate, generate, commit do .ioc).
• suya req — adicione e liste os requisitos de um projeto (suya req add, suya req list).
• suya review — revisões de código e design (create, show, list, comment, reply, resolve, approve e mais).
• suya diagram — crie e renderize diagramas Mermaid em SVG/PNG (create, update, show, list, export, render, delete).

Comandos de nível superior

Comando	Descrição
suya version	Imprime metadados de versão.
suya update [--check]	Atualiza para o último release; --check apenas informa a disponibilidade.
suya install [--skills] [--path <p>] [--force]	Instala integrações do Subaya (suya-cli + bundles de skills do planner).
suya completion <shell>	Imprime o autocompletar de shell para o shell informado.