@volley/web-shell-cli

Private CLI package for launching Volley web-shell locally with TV-shell parity behavior.

Usage

npx @volley/web-shell-cli

This starts a local server (default http://127.0.0.1:3000) and opens a browser URL equivalent to shell launch.

Options

• --env dev|staging|prod|local (default: dev)
• --port <number> (default: 3000)
• --host <host> (default: 127.0.0.1)
• --open / --no-open (default: open browser)
• --device-id <id> (sets localStorage.volley_device_id)
• --game-controller-url <url> (deep-link)
• --launch-url <url> (alias for game-controller-url)
• --query <k=v&...> (additional query params)
• --verbose (request logging)

Examples

# Default dev launch
npx @volley/web-shell-cli

# Staging launch without auto-opening browser
npx @volley/web-shell-cli --env staging --no-open --port 3300

# Deep-link launch
npx @volley/web-shell-cli --game-controller-url "https://vly.gg/game?id=abc"

Health Endpoint

The server exposes metadata:

curl http://127.0.0.1:3000/__health

Response includes:

• status
• cliVersion
• vwrLoaderVersionPinned
• env
• assetBuildId
• startedAt

Loader Version Pinning

This package pins @volley/vwr-loader in package.json and embeds prebuilt loader assets for local/dev/staging/prod.

Regenerate embedded assets with:

pnpm --filter @volley/web-shell-cli run assets:sync

Pinned loader version is printed on startup and returned by /__health.