The npm package @robusty/cli runs a test suite from your terminal or CI/CD instead of the dashboard. It starts a launch, streams the agent's progress live, and exits with a non-zero status when a test fails.

Installation

Install it globally:

npm install -g @robusty/cli

Or run it without installing:

npx @robusty/cli login

The CLI needs Node.js. Every example below assumes robusty is on your PATH. If you use npx, replace robusty with npx @robusty/cli, for example:

npx @robusty/cli launch --suite <suite-id>

Log in and link a project

robusty login authenticates you in the browser and links the current directory to a Robusty project. Run it once per machine, from your project's working directory:

robusty login

The link is stored locally and tells later commands which project to target. If you're already logged in, link (or re-link) the current directory with robusty link:

robusty link
robusty link --project "My Project"   # by exact project name or project UID

Without --project, the command prompts you to pick a project. With it, pass the project's exact name or its UID to select one directly.

In CI you don't run login or link. Authenticate with a project token instead — see CI/CD integration.

Launch a test suite

robusty launch runs a suite in the linked project. Pass the suite ID with --suite (find it in the suite's settings in the dashboard):

robusty launch --suite <suite-id>

The CLI streams the agent's progress as the run unfolds and exits non-zero if any test case fails, so a failing launch fails your script or pipeline.

Overriding variables

Override project variables for a single launch with repeatable --var KEY=VALUE flags. The stored value is left unchanged; the override applies only to this run:

robusty launch --suite <suite-id> \
  --var PROJECT_URL=https://pr-34.example.com \
  --var TEST_USER=demo

The most common use is pointing {{PROJECT_URL}} at a preview deployment so one suite validates any environment. Learn more about variable overrides.

Log out

robusty logout clears the stored credentials from the current machine:

robusty logout

Help

Pass --help to any command to see its flags:

robusty --help
robusty launch --help

CLI