O CLI num relance

O CLI microlab oferece pelo terminal tudo o que um utilizador pode fazer na app de ambiente de trabalho: gerir o catálogo (micros, cenários, mocks, definições), arrancar e parar cenários, observar estado e logs, e importar/exportar. UI e CLI partilham o mesmo motor através do registo de operações, por isso não divergem.

Executar

O CLI precisa do motor compilado (npm run build:electron).

node bin/microlab.js <comando>   # direto
npm run cli -- <comando>          # via npm (note o separador --)
microlab <comando>                # se registou o global com npm link

Flags globais

Flag	Efeito
--json	Saída JSON numa linha, para scripts. Os erros saem por stderr como {"error": "..."}.
-p, --project <caminho>	Raiz do projeto MicroLab (a pasta com .microlab/).
-V, --version	Versão.
-h, --help	Ajuda (todos os subcomandos a têm).

Códigos de saída

Código	Significado
0	Sucesso.
1	Erro de execução (a operação falhou).
2	Erro de uso (comando/flags inválidos).
3	O comando requer um motor vivo e não há.
4	Timeout (por exemplo à espera de que os micros estejam healthy).
5	Requer um plano pago que a conta não tem.

Acesso pago

Se o projeto configura início de sessão, o CLI (capacidade cli), o MCP (mcp) e o copiloto (chat) são pagos e independentes. O entitlement obtém-se iniciando sessão na app pelo menos uma vez. Em projetos sem início de sessão, o CLI não tem restrições. Ver Capacidades.

Motor vivo vs in-proc

Os micros são processos filhos do motor, por isso algo tem de continuar vivo depois de microlab start. O CLI resolve cada comando assim:

1. Se houver um motor vivo (a app aberta ou o daemon headless que o próprio CLI lança), o comando executa-se contra ele por HTTP: o CLI vê e governa o mesmo estado que a UI.
2. Se não houver, as operações sem estado (catálogo, mocks no disco, definições, pacotes) executam-se in-proc sobre .microlab/. As que exigem estado vivo falham com exit 3.

microlab start lança o daemon automaticamente se for preciso; microlab daemon stop desliga-o.

Ver também

• Comandos por grupo · Control server · Fluxos típicos