node package manager



Web test automation solution, built for agile teams. Testim is a cloud service that instantly enables Test Automation to make you Continuous Delivery ready.


Install the testim CLI globally:

$ npm i -g @testim/testim-cli

CLI Options



Use the token you got from (if you don't have one email

testim --token my.token



Select which project to run tests from

testim -project "My Project"


 --label or -l

Run all tests comprising one of the mentioned labels

testim -l my-label1 -l my-label2

Run by test name:

testim -n test-name1 -n test-name2

Grid host url


Grid host port

 --port or -p

Run on a specific Selenium Grid

testim -host -p 4444

Console Reporter

testim --reporters console

JUnit Reporter

testim --reporters junit --report-file ~/report.xml

TeamCity Reporter

testim --reporters teamcity

Base URL


Starting URL after browser opens

testim --base-url

Applitools Key

testim --applitools-key sadfsdflkjdsf-sdf-fds

Sauce Labs Key

testim --sauce-key sadfsdflkjdsf-sdf-fds

Sauce Labs User

testim --sauce-user sadfsdflkjdsf-sdf-fds

BrowserStack Key

testim --browserstack-key sadfsdflkjdsf-sdf-fds

BrowserStack User

testim --browserstack-user sadfsdflkjdsf-sdf-fds

BrowserStack Options

testim --browserstack-options browser-stack.json

BrowserStack Options Config File Example

   "browserName" : "chrome",
   "browser_version" : "53.0",
   "os" : "Windows",
   "os_version" : "7"


Open a tunnel between your local server and the selenium server.
Test base url will be replaced by the tunnel url.

--tunnel-port <SERVER_PORT> - optional
testim --tunnel --tunnel-port 8080

Version Control (Branches)

To run on a specific branch, use this parameter in your CLI

--branch <branch-name>

If you are using one of the following: Jenkins, CircleCI or TravisCI, The Testim CLI will automatically run tests for the same branch if the following parameter is used.

--branch auto-detect


All rights reserves to Testim Computerized Verifications Inc. 2015