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.

testronaut <mission> -o mfa=<nickname>​

Tell the automated MFA tool which stored MFA nickname to use for this run.

testronaut login.mission.js -o mfa=github-test-mfa

The CLI uses the sessionToken from testronaut-config.json and calls the Testronaut API to retrieve the current TOTP code. Creating or updating stored MFA entries is a premium feature, but reading existing MFA entries does not require premium access if an account later downgrades.

For the full setup flow, see Automated MFA Codes.

testronaut --dev --vercel-bypass=<secret>​

Use the staging API and send the Vercel protection bypass header for protected deployments.

testronaut --dev --vercel-bypass=YOUR_SECRET login.mission.js -o mfa=github-test-mfa

This is commonly needed when testing automated MFA against staging.