create

Download and install a specified browser.

Usage

pbvm create [-b <browser>] [-i <buildId>] [-a <alias>] [-m <mirror>] [-r <rule>] [-s]

Options

Option	Short	Description
--browser	-b	Browser name: chrome, chromium, firefox
--build-id	-i	Browser version; format varies by browser
--alias	-a	Alias for the browser, to simplify subsequent commands
--mirror	-m	Path to a mirror rule file; defaults to .browsermr in CWD then global
--rule	-r	Custom mirror template params in URL search format: a=1&b=2, replaces template variables
--store	-s	Download to the global Store only; do not write to browserlist.json

buildId format

Browser	buildId format	Example
chrome	x.x.x.x (4-part version)	134.0.6998.35
chromium	Numeric revision number	1435764
firefox	channel_version	stable_136.0.0

Examples

Interactive mode

Run without arguments and follow the prompts:

pbvm create

Interactive flow:

1. Select browser type (chrome / chromium / firefox)
2. Enter the corresponding buildId
3. Enter an alias (optional; auto-generated if left empty)
4. Confirm to start download and installation

CLI mode

# Install Chrome and set an alias
pbvm create -b chrome -i 134.0.6998.35 -a my-chrome

# Install Chromium (save to Store only, no project record)
pbvm create -b chromium -i 1435764 -s

# Install Firefox
pbvm create -b firefox -i stable_136.0.0

Behavior

• Before installing, pbvm checks whether the same browser already exists in the global Store and skips the download if found
• After a successful install, the browser is recorded in browserlist.json by default
• The -s flag downloads the binary to the global cache only, without a project association
• If the install is interrupted or fails, partially downloaded files are automatically cleaned up