Skip to main content

CLI Reference

npx testronaut --init​

Scaffold missions and config.

npx testronaut --turns=<n>​

Override max turns for this run (e.g., --turns=30).

npx testronaut --provider=<n>​

Override provider used for this run (e.g., --provider=openai). Note that this will override the testronaut default config. Model used should be associated with the chosen LLM provider (e.g., npx testronaut --provider=gemini --model=gpt-5.1 will not function properly).

npx testronaut --model=<n>​

Override model used for this run (e.g., --model=gpt-5.1). Note that this override should use the same LLM provider.

npx testronaut <name of mission.mission.js​

Execute missions in missions/ if no mission file is given. If a mission file is give, it will only run the one mission.

npx testronaut login​

Manage authentication.

npx testronaut upload​

Upload the JSON report for a run.

npx testronaut serve​

View the most recent html report.

npx testronaut view​

View the most recent html report. Alias for serve.