AIUBY Compute
CLI aiuby
A linha de comando da AIUBY: Compute, leitura da engenharia e portões de CI pela API v1, com autenticação por chave, comandos e códigos de saída.
#Instalação
A CLI exige Node.js 20 ou mais novo e é instalada pelo npm:
npm install -g @aiuby-ia/cli
aiuby --versionComo alternativa, o mesmo pacote é servido pelo site:
npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz#Autenticação
A CLI usa uma chave de API do workspace, que é o "projeto" dela. Crie a chave só com os escopos que vai usar: no Compute são "Ler o Compute", "Gerenciar aplicações do Compute" e, para implantar, "Implantar no Compute"; na engenharia, o escopo de cada comando está na tabela abaixo. aiuby login aceita chave só de engenharia.
aiuby login # cola a chave; ela não aparece na tela
aiuby whoami- A chave nunca é aceita como argumento, para não ficar no histórico do terminal.
- Ela fica em
~/.config/aiuby/credentials.json, com permissão restrita ao seu usuário. - A CLI fala só com a API da AIUBY: nunca pede credenciais de nuvem.
Em automação, sem interação:
printf '%s' "$CHAVE" | aiuby login
# ou, sem guardar nada em disco:
export AIUBY_TOKEN="aiuby_..."#Primeiro uso
aiuby init fastapi-http minha-api # copia um template de partida
cd minha-api
aiuby config validate # confere o aiuby.toml, sem usar a rede
aiuby apps create # cadastra; não implanta
aiuby deploy --dry-run minha-api # mostra o plano
aiuby deploy minha-api # pago (saldo e teto) ou na prévia liberada pela equipe
aiuby logs minha-api # últimas linhas de log
aiuby stop minha-apiOs templates de partida são fastapi-http, langgraph-agent, vllm-openai, hf-stable-diffusion e yolo-detect.
#Comandos
Versão 0.11.0. Cada comando pede uma chave com o escopo indicado (o rótulo é o da tela Acesso → Chaves de API). Todos aceitam --json; listas aceitam --limit e --cursor. Os comandos de engenharia usam a API v1 e pedem o Cortex ativo (avaliações, o Agents).
Compute e conta
Escopos "Ler o Compute", "Gerenciar aplicações do Compute" e, para implantar, "Implantar no Compute".
| Comando | O que faz | Escopo |
|---|---|---|
aiuby init [template] [diretório] | Copia um template; sem argumento, lista os templates | — |
aiuby login [--url <endereço>] | Guarda uma chave de API, depois de conferir com a API | — |
aiuby logout | Apaga a chave deste computador | — |
aiuby whoami | Organização, workspace e endereço da API | — |
aiuby project list | O projeto (workspace) da chave | — |
aiuby apps list | Aplicações do workspace | — |
aiuby apps status <id> | Detalhe, revisões e plano de uma aplicação | — |
aiuby apps create [arquivo] | Cadastra a aplicação do aiuby.toml, com a primeira revisão | — |
aiuby apps update [arquivo] | Grava a configuração como nova revisão | — |
aiuby capacity list [--provider gcp|aws] | Catálogo de hardware, como referência | — |
aiuby config validate [arquivo] | Valida um aiuby.toml local, sem rede | — |
aiuby deploy --dry-run <id> | Mostra o plano, sem criar nada | — |
aiuby deploy [--no-wait] <id> | Implanta a revisão atual e acompanha até ficar em execução | compute:deploy |
aiuby stop <id> | Para a implantação e apaga o serviço | compute:deploy |
aiuby rollback <id> <N> | Grava uma revisão nova com a configuração da revisão N; não implanta | — |
aiuby secrets list|set|delete <id> <NOME> | Segredos da aplicação; o valor vem do terminal (sem eco) ou da entrada padrão | — |
aiuby token <id> | Token de 1 hora para aplicação com endereço protegido | compute:invoke |
aiuby logs [--limit N] <id> | Últimas linhas de log da implantação mais recente | — |
aiuby billing | Saldo, teto e gasto do mês de Compute, e os tamanhos com preço | — |
aiuby usage [--limit N] | Extrato do Compute | — |
aiuby rollout status|start|promote|pause|resume|abort <app> | Canary e blue-green no Compute (status lê; o resto pede compute:deploy) | — |
aiuby doctor | Confere ambiente, credencial e resposta da API | — |
Grafo e Engineering Intelligence
| Comando | O que faz | Escopo |
|---|---|---|
aiuby graph services [--query <texto>] | Serviços do catálogo de engenharia | engineering:read |
aiuby graph ask "<assunto>" [--intent <intenção>] | Consulta estruturada ao grafo, sem modelo, com as fontes | engineering:read |
aiuby graph entity <id> [--depth 1-3] | Entidade e as ligadas a ela | engineering:read |
aiuby graph events | Últimos eventos de código, catálogo, implantação e SLO | engineering:read |
aiuby insights delivery [--days N] | Indicadores de entrega com amostra | engineering:read |
aiuby dora [--service S | --team T] [--days N] | DORA com fórmulas e tendência semanal | engineering:read |
aiuby intel [--days N] [--team T] | Relatório por time: DORA, PRs, itens e sprints | engineering:read |
aiuby ai-efficiency [--days N] | Assentos de ferramentas de IA, ociosos e custo desperdiçado | engineering:read |
aiuby work-items push <arquivo.json> | Envia itens de trabalho (até 500) | engineering:ingest |
aiuby code-review list|get <id>|branch-policy|metrics | Revisões de PR por IA, política de branch e métricas | engineering:read |
aiuby code-review check --repo R --pr N --sha S | Portão de revisão do PR (sai 6 se não passar) | engineering:read |
SLOs, incidentes, runbooks e flags
| Comando | O que faz | Escopo |
|---|---|---|
aiuby slos list|get <id>|composites|composite <id> | SLOs, orçamento de erro e SLOs compostos | engineering:read |
aiuby incidents list|get <id> | Incidentes e os alertas agrupados | engineering:read |
aiuby runbooks list|get <id> | Runbooks e os passos da versão atual | engineering:read |
aiuby flags list|cleanup | Flags por ambiente e candidatas a limpeza | engineering:read |
Segurança, supply chain e APIs
| Comando | O que faz | Escopo |
|---|---|---|
aiuby security findings [--severity] [--status] [--tool] [--category] | Achados dos scanners | engineering:read |
aiuby security scans [get <id>] | Scans e os achados de cada um | engineering:read |
aiuby security scan --repo R [--scanner S]... [--wait] | Pede um scan | security:scan |
aiuby security gate --repo R [--fail-on] [--kev] [--epss-at-least] | Portão de severidade (sai 6 se reprovar) | security:read |
aiuby security upload-sarif|upload-sbom <arquivo> --repo R | Envia SARIF ou SBOM de outra ferramenta | security:write |
aiuby sbom get <dono/nome> [--format]|where <pacote|purl|CVE> | SBOM do repositório e busca de pacote ou CVE | engineering:read |
aiuby apis list|get|drift|spec|findings|applications|policies | Inventário e postura de APIs | engineering:read |
aiuby apis traffic <arquivo.json> | Envia tráfego do gateway (até 2.000 linhas) | api-security:ingest |
aiuby api-protection list|get|stats|samples | Proteção de API em tempo de execução | engineering:read |
Entrega, código e testes
| Comando | O que faz | Escopo |
|---|---|---|
aiuby pipelines list|runs|run|templates|variables | Pipelines, execuções, modelos e nomes de variáveis | engineering:read |
aiuby artifacts list|tags | Imagens e pacotes do registro de artefatos | engineering:read |
aiuby artifacts login --repository R | Credencial de 15 minutos para docker login | compute:deploy |
aiuby releases list|get <id> | Releases em Kubernetes (get sai 0, 7, 6 ou 1 pelo estado) | engineering:read |
aiuby releases approve <id> | Aprova o estágio que espera (não aprova produção) | delivery:approve |
aiuby releases rollback <id> [--reason] | Volta a release à versão anterior | delivery:rollback |
aiuby iac check|applied | Portão de IaC no CI e registro do apply | iac:check |
aiuby iac plan|runs|run|apply|insight|report | Plan e apply gerenciados com OpenTofu | iac:run |
aiuby db check <migrações.sql...> | Portão de migrações no CI | db:check |
aiuby db databases|migrations|schema-diff | Bancos, histórico e diferença de schema | db:read |
aiuby db report|gate|snapshot <arquivo.json> | Relato de migração, portão antes de aplicar e retrato do schema | db:report |
aiuby resilience check | Riscos de resiliência novos do PR (sai 6 se bloquear) | resilience:check |
aiuby tests run|status | Suíte Playwright no executor isolado | tests:run |
aiuby test-plans list | Planos de teste declarativos | engineering:read |
aiuby load-tests scenarios list|get|create|delete | Cenários de carga | load-test:run |
aiuby load-tests run|status | Execução de carga e veredito | load-test:run |
aiuby catalog list|get, scorecard, scorecards list|get, portal adoption | Developer Portal | engineering:read |
aiuby code search <texto> | Busca nos repositórios indexados | engineering:read |
aiuby tickets list | Tickets do Code Automation | engineering:read |
Agentes e MCP
| Comando | O que faz | Escopo |
|---|---|---|
aiuby skills list|get <nome> | Skills publicadas; get imprime o SKILL.md e o sha256 | skills:read |
aiuby evals cases|add-case|run|latest|get | Suíte de avaliação de um agente (run --wait sai 6 se reprovar) | agents:eval |
aiuby mcp config [--client claude|cursor|generic] | Bloco de configuração do servidor MCP; não imprime a chave | — |
Os comandos run, scale, volumes e domains existem, mas respondem que ainda não estão disponíveis (saída 4). A referência completa, com todas as opções, está no README do pacote.
#Variáveis de ambiente
| Variável | Efeito |
|---|---|
AIUBY_TOKEN | Chave de API. Tem prioridade sobre o arquivo; use em automação |
AIUBY_API_URL | Endereço da API. O padrão é https://aiuby.com |
AIUBY_CONFIG_DIR | Diretório do arquivo de credencial |
#Códigos de saída
| Código | Significado |
|---|---|
| 0 | Sucesso |
| 1 | Erro de rede, de servidor ou falha no doctor |
| 2 | Uso incorreto |
| 3 | Não autenticado |
| 4 | Recusado: indisponível, não encontrado, sem permissão ou plano com bloqueios |
| 5 | Configuração inválida |
| 6 | Bloqueado pelo portão: check de resiliência, IaC ou migração negado, teste ou carga reprovados, portão de segurança, de revisão ou de banco reprovado, release com portão fechado |
| 7 | Aguardando aprovação, ou ainda rodando no fim da espera (--wait) |