Das CLI auf einen Blick

Das microlab-CLI bietet vom Terminal aus alles, was ein Benutzer in der Desktop-App tun kann: den Katalog verwalten (Micros, Szenarien, Mocks, Einstellungen), Szenarien starten und stoppen, Status und Logs beobachten und importieren/exportieren. UI und CLI teilen dieselbe Engine über das Operationsregister, sie laufen also nicht auseinander.

Ausführen

Das CLI benötigt die kompilierte Engine (npm run build:electron).

node bin/microlab.js <Befehl>   # direkt
npm run cli -- <Befehl>          # über npm (beachten Sie den Trenner --)
microlab <Befehl>                # wenn Sie das Global mit npm link registriert haben

Globale Flags

Flag	Wirkung
--json	JSON-Ausgabe in einer Zeile, für Skripte. Fehler gehen über stderr als {"error": "..."}.
-p, --project <Pfad>	MicroLab-Projektwurzel (der Ordner mit .microlab/).
-V, --version	Version.
-h, --help	Hilfe (alle Unterbefehle haben sie).

Exit-Codes

Code	Bedeutung
0	Erfolg.
1	Ausführungsfehler (die Operation schlug fehl).
2	Nutzungsfehler (ungültiger Befehl/Flags).
3	Der Befehl benötigt eine aktive Engine und es gibt keine.
4	Timeout (zum Beispiel beim Warten, dass die Micros healthy sind).
5	Benötigt einen kostenpflichtigen Plan, den das Konto nicht hat.

Kostenpflichtiger Zugriff

Wenn das Projekt eine Anmeldung konfiguriert, sind das CLI (Fähigkeit cli), das MCP (mcp) und der Copilot (chat) kostenpflichtig und unabhängig. Das Entitlement erhält man durch mindestens einmaliges Anmelden an der App. In Projekten ohne Anmeldung hat das CLI keine Einschränkungen. Siehe Fähigkeiten.

Aktive Engine vs in-proc

Die Micros sind Kindprozesse der Engine, also muss nach microlab start etwas aktiv bleiben. Das CLI löst jeden Befehl so auf:

1. Wenn es eine aktive Engine gibt (die App offen oder der headless Daemon, den das CLI selbst startet), wird der Befehl gegen sie über HTTP ausgeführt: Das CLI sieht und steuert den gleichen Zustand wie die UI.
2. Wenn es keine gibt, werden die zustandslosen Operationen (Katalog, Mocks auf der Festplatte, Einstellungen, Pakete) in-proc über .microlab/ ausgeführt. Die, die einen aktiven Zustand erfordern, scheitern mit exit 3.

microlab start startet den Daemon automatisch, wenn nötig; microlab daemon stop schaltet ihn ab.

Siehe auch

• Befehle nach Gruppe · Control server · Typische Abläufe