Skip to main content

☄️ Troubleshooting

Invalid session token​

  • testronaut login should revalidate auth.
  • Or regenerate your API key.

Cannot find report file​

  • Ensure missions/mission_reports/runs_<runId>.json exists (CI won’t clean the workspace early).

Flaky hover / drawers / expanding menus​

  • Prefer tools.hoverAndClick(selector) and add if Failure, retry this mission to the mission text.

testronaut: command not found​

This error means the testronaut command is not available in your shell's PATH. You have three options:

Option 1 — Global install (recommended)

Install the CLI globally so the testronaut command is available everywhere:

npm install -g testronaut

After this, run testronaut directly from any directory.

Option 2 — Use npx (no install needed)

Prefix every command with npx to run the CLI without a global install:

npx testronaut --init
npx testronaut your-mission.mission.js

Option 3 — Local project install via npm link

If you have a local clone of the testronaut-cli repository, you can link it into your global PATH from the project directory:

cd path/to/testronaut-cli
npm link

This makes your local build available as the testronaut command globally.