명령줄

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

인자

인자	별칭	타입	기본값	역할
--open <path>	-o	문자열	—	시작할 때 열 파일 또는 폴더. --run 과 함께 쓸 때는 필수입니다
--run <target>		문자열	—	지정한 이름의 시나리오를 실행하고 종료합니다. 명령줄 모드를 활성화합니다
--by <name|id>		목록	name	--run 이 시나리오를 지목하는 방식
--headless		불리언	false	창을 띄우지 않습니다. 지정하지 않으면 실행 중에 창이 표시됩니다
--param name=value		반복 가능	—	시나리오 파라미터를 전달합니다
--all-logs		불리언	false	Log 액션의 항목만이 아니라 엔진의 항목까지 포함합니다
--out <file>		문자열	—	로그를 파일에도 실시간으로 기록합니다
--clear-settings	-cls	불리언	false	실행 전에 환경 설정을 초기화합니다
--inactive-window		불리언	false	창을 표시하되 포커스는 주지 않습니다
--quiet	-q	불리언	—	출력을 실행 로그만으로 줄입니다. --run 이 있으면 자동으로 추가됩니다
--mcp-session-name <name>		문자열	자동	MCP 세션의 이름을 지정합니다 (환경 변수 RESTORM_MCP_SESSION_NAME 도 참고하십시오)
--help	-h			도움말을 표시합니다
--version	-v			버전을 표시합니다

종료 코드

코드	의미
0	시나리오가 정상적으로 끝났습니다
1	실패, 취소, 또는 엔진 오류
2	대상을 찾을 수 없음, --out 파일에 접근할 수 없음, 또는 --open 없이 쓴 --run
3	권한 거부 — 토큰이 없거나 유효하지 않거나 취소됨, 플랜이 부족함, 또는 확인 엔드포인트에 도달할 수 없음

환경 변수

변수	역할
RESTORM_TOKEN	헤드리스 실행에 필요한 조직 토큰 (rstk_…)
RESTORM_MCP_SESSION_NAME	--mcp-session-name 과 동일한 역할

환경 변수 유형의 비밀 값도 프로세스의 환경에서 읽어 들입니다. 지속적 통합에서 권장하는 방식입니다.

예시

프로젝트 열기.

restorm --open ./api.restorm

창을 띄운 채로 시나리오 실행하기 (동작을 눈으로 확인할 때 편리합니다).

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

창 없이, 파라미터와 전체 로그를 붙여서 실행하기.

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

출력 형식, 파라미터 변환, 파이프라인 예시는 헤드리스 실행과 지속적 통합을 참고하십시오.