Skip to main content

The Trq CLI

The trq CLI is a single, standalone program that replays the tests you recorded in Trq — web or mobile, headed or headless — from the command line. It's built for automation: run it on your machine to reproduce a flow, or drop it into a CI pipeline to gate every merge.

It's a single downloadable binary. No app, no Node, no npm, nothing to install alongside it. The first time it runs a web test it downloads a Chromium browser and caches it; after that it's fully self-contained.

Record in the app, run with the CLI​

  • Trq Studio (the desktop app) is where you record and edit tests.
  • The trq CLI is where you run them — locally in a terminal, or automatically on a build server.

They read the same .trq files from your project folder, so anything you record opens straight in the CLI.

A first run​

trq play checkout

Trq launches a browser (invisibly by default), replays each step of the checkout test, prints per-step pass/fail, and exits 0 if everything passed or 1 if anything failed — so a run is a ready-made CI gate.

Want to watch it happen? Add --headed:

trq play checkout --headed

What's next​

  • Install — one line, or a direct download.
  • Running tests — one test, a whole folder, or a suite.
  • In CI — reports, exit codes, and ready-to-copy pipeline examples.
  • Mobile — driving an emulator or device.
  • Reference — every command, flag, and environment variable.