@useragent-kit/headless-useragent

CLI for testing ProductView bundles against a real Triangle User Agent engine.

headless-useragent-webview is a native binary that spins up a headless WebView runtime, loads your product bundle, and drives it through a configurable test scenario — all without a display server.

Installation

npm install --save-dev @useragent-kit/headless-useragent

The package installs the matching npm platform binary package when your OS and CPU are supported.

Usage

npx @useragent-kit/headless-useragent --product-dir ./dist --mnemonic "word1 word2 ... word12" --timeout 30

Or, if installed locally:

npx headless-host --product-dir ./dist --mnemonic "word1 word2 ... word12" --timeout 30

Run with --help to see all available flags:

npx headless-host --help

When to use it

Use this package when you want:

• CI smoke tests against a real host runtime
• local ProductView validation without a full desktop/mobile shell
• deterministic scripting around product bundle loading, wallet state, and timeouts

Documentation

• Headless testing guide: https://github.com/paritytech/useragent-kit/blob/main/site/src/content/docs/guides/headless-testing.md
• Releases: https://github.com/paritytech/useragent-kit/releases

Supported Platforms

| OS | Architecture | | ----- | --------------------- | | macOS | arm64 (Apple Silicon) | | Linux | x64 |

Environment Variables

| Variable | Description | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | HEADLESS_HOST_BINARY | Path to a local headless-useragent-webview binary. When set, the wrapper uses this binary instead of the npm platform package. Useful for source builds and unsupported local platforms. |