Le CLI en un coup d'œil

Le CLI microlab offre depuis le terminal tout ce qu’un utilisateur peut faire dans l’application de bureau : gérer le catalogue (micros, scénarios, mocks, paramètres), démarrer et arrêter des scénarios, observer l’état et les logs, et importer/exporter. UI et CLI partagent le même moteur via le registre d’opérations, ils ne divergent donc pas.

Exécuter

Le CLI a besoin du moteur compilé (npm run build:electron).

node bin/microlab.js <commande>   # direct
npm run cli -- <commande>          # via npm (notez le séparateur --)
microlab <commande>                # si vous avez enregistré le global avec npm link

Flags globaux

Flag	Effet
--json	Sortie JSON sur une ligne, pour les scripts. Les erreurs sortent en stderr comme {"error": "..."}.
-p, --project <chemin>	Racine du projet MicroLab (le dossier avec .microlab/).
-V, --version	Version.
-h, --help	Aide (tous les sous-commandes l’ont).

Codes de sortie

Code	Signification
0	Succès.
1	Erreur d’exécution (l’opération a échoué).
2	Erreur d’usage (commande/flags invalides).
3	La commande nécessite un moteur actif et il n’y en a pas.
4	Timeout (par exemple en attendant que les micros soient healthy).
5	Nécessite un plan payant que le compte n’a pas.

Accès payant

Si le projet configure une connexion, le CLI (capacité cli), le MCP (mcp) et le copilote (chat) sont payants et indépendants. L’entitlement s’obtient en se connectant à l’app au moins une fois. Dans les projets sans connexion, le CLI n’a pas de restrictions. Voir Capacités.

Moteur actif vs in-proc

Les micros sont des processus enfants du moteur, donc quelque chose doit rester actif après microlab start. Le CLI résout chaque commande ainsi :

1. S’il y a un moteur actif (l’app ouverte ou le daemon headless que le CLI lui-même lance), la commande s’exécute contre lui en HTTP : le CLI voit et gouverne le même état que l’UI.
2. S’il n’y en a pas, les opérations sans état (catalogue, mocks sur disque, paramètres, paquets) s’exécutent in-proc sur .microlab/. Celles qui exigent un état actif échouent avec exit 3.

microlab start lance le daemon automatiquement si nécessaire ; microlab daemon stop l’éteint.

Voir aussi

• Commandes par groupe · Control server · Flux typiques