uilicious-cli

library5.1.15jsnpmunverified

Uilicious CLI is a command-line tool for running and managing UI-licious end-to-end user journey tests. Version 5.1.15 supports Node.js >=10.0.0 and npm >=5.6.0. It allows authentication via access keys or username/password, and test execution with configurable browser, viewport, and dynamic data objects. The CLI is designed for teams with active UI-licious subscriptions, offering both npm and direct binary downloads. It differs from other test runners by tightly integrating with the UI-licious cloud platform.

testing devops

npm install uilicious-cli

package ↗homepage ↗

INSTALL

IMPORT

SIG · UILICIOUS-CLI

uilicious-cli

testingjavascriptv5.1.15

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import uilicious from 'uilicious-cli'

✗ const uilicious = require('uilicious-cli')

ESM-only package; no default export for programmatic use – CLI is primarily used via command line.

UiliciousCli

✓ import { UiliciousCli } from 'uilicious-cli'

✗ import { Cli } from 'uilicious-cli'

Named export for programmatic API; requires manual instantiation.

runTest

✓ import { runTest } from 'uilicious-cli'

✗ import { run } from 'uilicious-cli'

Named export for running tests programmatically; accepts options object.

Shows how to run a UI-licious test via CLI with access key authentication.

// Run a test via CLI // Authenticate and run a test with access key process.env.UILICIOUS_ACCESSKEY = process.env.KEY ?? ''; const { execSync } = require('child_process'); const cmd = 'uilicious-cli project run "MyProject" "/login/test" --key ' + process.env.UILICIOUS_ACCESSKEY; const output = execSync(cmd, { encoding: 'utf8' }); console.log(output);

uilicious-cli --version

Debug

Known issues

breakingThe CLI requires an active UI-licious subscription and will fail without valid credentials.

fix

Obtain a valid access key from UI-licious Studio.

affects: >=0.0.0

deprecatedAuthorization via username/password (`--user`, `--pass`) is deprecated in favor of access key.

fix

Use `--key` or `UILICIOUS_ACCESSKEY` environment variable.

affects: >=5.0.0

gotchaThe `--dataObject` option expects a JSON string; spaces in the JSON will break parsing.

fix

Enclose the JSON in single quotes and avoid spaces, or use `--dataFile` instead.

affects: >=0.0.0

gotchaGlobal installation via npm may fail on Node.js <10 because of engine restrictions.

fix

Update Node.js to >=10 or use binary downloads from GitHub releases.

affects: <5.0.0

Errors

Common errors & fixes

Error: You do not have an active subscription. Please check your account.

Trying to run tests without a valid UI-licious subscription.

fix

Ensure you have an active subscription and a valid access key set via `--key` or `UILICIOUS_ACCESSKEY`.

Error: Invalid access key

The access key provided is incorrect or expired.

fix

Regenerate a new access key from UI-licious Studio and use `--key` or `UILICIOUS_ACCESSKEY`.

Error: Cannot find module 'uilicious-sdk'

Missing dependency when trying to import the package programmatically.

fix

Run `npm install uilicious-sdk` alongside `uilicious-cli`.

Upgrade

Version history

5.1.15latest on npm

Audit

Dependencies

uilicious-sdkrequiredSDK for UI-licious API interactions

Agent activity

7 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/uilicious-cli ↗

homepagehttps://uilicious.com ↗