Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
uilicious-cli-code @ 1176657

UI-licious Command Line Interface


UI-licious is a tool for development teams to rapidly create and run end-to-end user journey tests for their web applications.

This command line interface allows you to run and manage your UI-licious tests through the command line.

Note that the UI-licious CLI can only be used with an active subscription of UI-licious.


You may install the CLI by downloading the recommended binary distribution, or via NPM.

Download binaries directly from our github release page (recommended)

Older releases

Download via npm

Before installing this package, ensure that npm is updated to the latest version:

$ npm install npm@latest -g

Run the following to install uilicious-cli globally:

$ npm install uilicious-cli -g

Using --help

Use the --help option to list the available commands:

$ uilicious-cli --help


To get more information about a single command, use --help after the command:

$ uilicious-cli <command> --help

Run Help


You can use your access key or username and password to authenticate yourself.

Authentication with access key

Where can I get my access key?

Login to UI-licious Studio, go to "Account and Billing > Access Key" to view and regenerate your access key

You can set your access key with the --key option when using the cli, e.g.:

$ uilicious-cli run "demo" "/login/test 1" --key <acccess_key>

Authentication with username and password

Alternative you can authenticate with your username and password, using the --user and --pass options e.g.

$ uilicious-cli run "demo" "/login/test 1" --user <username> --pass <password>

You can also use the short form -u or -p, e.g.:

$ uilicious-cli run "demo" "/login/test 1" -u <username> -p <password>


Warning: Please avoid using deprecated aliases for the commands, as they can be removed in the future.

Name Deprecated aliases Purpose
run Run a test
download export Download a project to a local directory
upload import Upload files from a local directory to a project

Running a test

$ uilicious-cli run  <project_name> <script_path> [--browser] [--width] [--height]
  • <project_name> - Name for the project being tested.
  • <script_path> - Name of the test script being executed.

Additional Options

  • --browser <browser_name> options : e.g. chrome, firefox, edge, safari, ie11 (default "chrome")
  • --height <browser_height> height of browser (default "960")
  • --width <browser_width> width of browser (default "1280")

Setting the DATA object

The DATA object is a special object you can use in the test script for dynamic test data.

You can use the DATA object in your script like this:

// Here's an example to help you get started!
I.goTo("")"Sign up")
I.see("Join GitHub")
I.fill("Username", DATA.username)
I.fill("Password", DATA.password)"Create an account")

You can set the DATA using a json string using --dataObject or by reading from json file using --dataFile.


$ uilicious-cli run "github" "Login" --dataObject {"username":"brucewayne","password":"secret","email":""}
$ uilicious-cli run "github" "Login" --dataFile "./user-brucewayne.json"


You can now configure variables for running tests on different environments.

You can manage the datasets in Uilicious Project editor. To run a test using dataset, you need to specify the name of dataset using --dataset.


uilicious-cli run Demo demo --dataset "PROD"

Test local applications

Plese services such as

Native ngrok support is deprecated from v3.0.0

Upload files to a project

You can upload files from a local directory to an UI-licious project using the upload command. If the project does not exists, it will be automatically created:

uilicious-cli upload <project_name> <local_directory>

Download files from a project

You can download files from a UI-licious project to a local directory using the download command. Files will be overwritten in the destination folder if they already exist.

uilicious-cli download <project_name> <local_directory>

Need help?


Copyright © 2019 Uilicious Private Limited