Référence CLI

Référence complète des commandes de la CLI miravo.

Options globales

Option	Défaut	Description
--log-level <niveau>	info	debug, info, warn, error
--log-format <format>	pretty	pretty ou json
--verbose	—	Alias pour --log-level debug
-q, --quiet	—	Supprimer la sortie formatée et les logs non-erreur
--plain	—	Sortie texte brut (sans couleurs/formatage)

Priorité : -q/--quiet > --log-level > --verbose. La variable d’env NO_COLOR force la sortie brute.

miravo start

Démarrer une simulation.

miravo start --template smart-factory
miravo start --template ./custom.miravo.yaml --name my-sim
miravo start -d  # Détacher (daemon en arrière-plan)

Option	Variable d’env	Défaut	Description
-t, --template <nom|chemin>	MIRAVO_TEMPLATE	Auto-sélection	Template à exécuter
-n, --name <nom>	MIRAVO_NAME	Dérivé du template	Nom de la simulation
-s, --speed <n>	—	Depuis le template	Multiplicateur de temps
-p, --mqtt-port <port>	MIRAVO_MQTT_PORT	1883	Port du broker MQTT
--mqtt-host <hôte>	MIRAVO_MQTT_HOST	127.0.0.1	Hôte d’écoute MQTT
--mqtt-mode <mode>	MIRAVO_MQTT_MODE	embedded	embedded ou external
--mqtt-url <url>	MIRAVO_MQTT_URL	—	URL du broker externe
--no-mqtt	—	—	Désactiver MQTT
--opcua	—	Désactivé	Activer OPC UA
--opcua-port <port>	MIRAVO_OPCUA_PORT	4840	Port OPC UA
--opcua-host <hôte>	MIRAVO_OPCUA_HOST	0.0.0.0	Hôte d’écoute OPC UA
--admin-port <port>	MIRAVO_ADMIN_PORT	8080	Port HTTP admin
--admin-host <hôte>	MIRAVO_ADMIN_HOST	127.0.0.1	Hôte d’écoute admin
-d, --detach	—	—	Exécuter en daemon arrière-plan
--dry-run	—	—	Valider sans exécuter
--seed <n>	—	Aléatoire	Graine RNG
--tick <ms>	—	Depuis le template	Intervalle de tick
--summary-interval <s>	—	30	Intervalle de log de résumé périodique

miravo ps

Lister les simulations en arrière-plan en cours.

miravo ps
miravo ps --json

miravo stop

Arrêter une simulation en cours.

miravo stop my-sim
miravo stop my-sim --timeout 10

miravo logs

Diffuser les événements de domaine d’une simulation en cours via WebSocket.

miravo logs my-sim
miravo logs my-sim --tail 50
miravo logs my-sim --channels faults,lifecycle

Canaux disponibles : tick, faults, lifecycle, instances, engine, adapters.

miravo status

Afficher les métriques et l’état de la simulation.

miravo status
miravo status --watch
miravo status --instance pump-001
miravo status --json
miravo status --discover    # Découverte basée sur MQTT

miravo inject

Déclencher ou effacer des défaillances. Sélecteur interactif quand les arguments sont omis.

miravo inject pump-001 cavitation
miravo inject pump-001 cavitation --clear
miravo inject    # Mode interactif (TTY)

miravo spawn

Ajouter des instances à la simulation en cours.

miravo spawn centrifugal-pump
miravo spawn centrifugal-pump --count 5

miravo remove

Supprimer une instance.

miravo remove pump-003

miravo pause / resume

miravo pause
miravo resume

miravo speed

Définir le multiplicateur de temps de simulation (1-1000).

miravo speed 50

miravo reset

Supprimer toutes les instances et les exécutions de template.

miravo reset
miravo reset --clear-persistence

miravo load

Charger des instances supplémentaires depuis un template.

miravo load ./extra-pumps.miravo.yaml
miravo load smart-factory --count 2

miravo adapter

Gérer les adaptateurs de protocole à l’exécution.

miravo adapter enable opcua --port 4840
miravo adapter disable mqtt

miravo models

miravo models list
miravo models inspect centrifugal-pump
miravo models inspect centrifugal-pump --raw

miravo templates

miravo templates list
miravo templates inspect smart-factory
miravo templates inspect smart-factory --raw

miravo fork

Copier du contenu intégré dans le registre local pour personnalisation.

miravo fork model centrifugal-pump
miravo fork template smart-factory
miravo fork template smart-factory --models-only
miravo fork template smart-factory --force

miravo rm

Forcer la suppression d’entrées obsolètes du registre daemon.

miravo rm old-sim
miravo rm old-sim --force