Skip to main content

CLI Reference

testronaut --init​

Scaffold missions and config.

testronaut --turns=<n>​

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

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., testronaut --provider=gemini --model=gpt-5.1 will not function properly).

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.

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.

testronaut login​

Manage authentication.

testronaut upload​

Upload the JSON report for a run.

testronaut serve​

View the most recent html report.

testronaut view​

View the most recent html report. Alias for serve.

testronaut --no-human-input​

Disable the human-in-the-loop verification prompt for this run. Useful for automated/CI environments where no one is at the terminal. When disabled, any mission instruction that would trigger a user prompt will fail immediately instead of waiting.

testronaut --human-input[=<bool>]​

Explicitly enable or disable human input for this run (e.g., --human-input=true, --human-input=false). --no-human-input is shorthand for --human-input=false.

testronaut --human-input-timeout=<s>​

Override the number of seconds the agent waits for a user to enter a verification code before timing out (e.g., --human-input-timeout=120). Accepted range: 5–300 seconds. Default: 60.