@runtimevault/cli
v1.0.4
Published
RuntimeVault CLI — login, replay snapshots, doctor, and release tooling
Maintainers
Readme
@runtimevault/cli
Official RuntimeVault CLI. Authenticate, diagnose setup, and replay production snapshots locally.
Works on macOS, Windows, and Linux (Node.js 20.10+).
Prerequisites
| | | |---|---| | Runtime | Node.js 20 LTS (or newer) | | Package manager | npm (included), pnpm, yarn, or bun | | Account | Free RuntimeVault account |
Install Node
macOS
brew install node
# or download LTS from https://nodejs.orgWindows
winget install OpenJS.NodeJS.LTS
# or installer from https://nodejs.org — then open a new terminalLinux
# nvm example
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 20
# or use your distro packages / Nodesource for Node 20+Install the CLI
# Global (all OS)
npm install -g @runtimevault/cli
# No global install — same on Mac / Windows / Linux
npx @runtimevault/cli --helpBinaries after global install:
rv(primary)runtimevaulttc(legacy alias)
Windows tip: if
npm install -gfails on permissions, usenpx @runtimevault/cli …— no native build tools required.
Quick start
rv login
rv whoami
rv doctor
rv replay snap_9f2a1cCommands
| Command | Description |
|---|---|
| rv login | Authenticate with RuntimeVault |
| rv logout | Clear stored credentials |
| rv whoami | Show the signed-in account |
| rv init | Scaffold project integration |
| rv verify | Verify SDK configuration |
| rv doctor | Diagnose common issues |
| rv replay [id] | Download a snapshot for local replay |
| rv release | Register a release / source maps |
| rv snapshot | Manual capture helpers |
Auth storage
| OS | Path |
|---|---|
| macOS / Linux | ~/.config/runtimevault/auth.json |
| Windows | %USERPROFILE%\.config\runtimevault\auth.json |
Replay flow
rv replay snap_9f2a1c
# writes .runtimevault/replays/<id>.json (+ HTML companion)Environment
| Variable | Description |
|---|---|
| RV_API_URL | Override API base (default https://api.runtimevault.dev) |
# macOS / Linux
export RV_API_URL=https://api.runtimevault.dev
# Windows PowerShell
$env:RV_API_URL = "https://api.runtimevault.dev"Links
License
MIT
