Riga di comando

restorm [--open <path>] [--run <target>] [options]

Argomenti

Argomento	Alias	Tipo	Predefinito	Ruolo
--open <path>	-o	stringa	—	File o cartella da aprire all’avvio. Obbligatorio con --run
--run <target>		stringa	—	Esegue lo scenario indicato ed esce. Attiva la modalità riga di comando
--by <name|id>		elenco	name	Come --run designa lo scenario
--headless		booleano	false	Nessuna finestra. Senza questo argomento la finestra appare durante l’esecuzione
--param name=value		ripetibile	—	Fornisce un parametro di scenario
--all-logs		booleano	false	Include le voci del motore, non soltanto quelle dell’azione Log
--out <file>		stringa	—	Scrive il log anche in un file, man mano
--clear-settings	-cls	booleano	false	Reimposta le preferenze prima del lancio
--inactive-window		booleano	false	Mostra la finestra senza darle il focus
--quiet	-q	booleano	—	Riduce l’output al solo log di esecuzione. Aggiunto automaticamente in presenza di --run
--mcp-session-name <name>		stringa	auto	Assegna un nome alla sessione MCP (si veda anche la variabile RESTORM_MCP_SESSION_NAME)
--help	-h			Mostra la guida
--version	-v			Mostra la versione

Codici di uscita

Codice	Significato
0	Lo scenario si è concluso correttamente
1	Fallimento, annullamento oppure errore del motore
2	Destinazione non trovata, file --out inaccessibile, oppure --run senza --open
3	Diritto negato — token assente, non valido o revocato, piano insufficiente, oppure punto di verifica non raggiungibile

Variabili d’ambiente

Variabile	Ruolo
RESTORM_TOKEN	Il token di organizzazione (rstk_…) richiesto dall’esecuzione headless
RESTORM_MCP_SESSION_NAME	Equivalente di --mcp-session-name

Anche i segreti di tipo variabile d’ambiente vengono letti nell’ambiente del processo: è il meccanismo consigliato in integrazione continua.

Esempi

Aprire un progetto:

restorm --open ./api.restorm

Eseguire uno scenario mostrando la finestra (comodo per osservare):

restorm --open ./api.restorm --run "Tests de fumée"

Eseguire senza finestra, con parametri e log completo:

RESTORM_TOKEN=rstk_… restorm \
  --open ./api.restorm \
  --run "Tests de fumée" \
  --headless \
  --all-logs \
  --out ./run.log \
  --param baseUrl=https://staging.exemple.test \
  --param Ids='[1,2,3]' \
  --param Env=staging

Si veda Esecuzione headless e CI per il formato di output, la conversione dei parametri ed esempi di pipeline.