qsva-cli

Command-line tool for QSVA Intersect — initialize your workspace, open the dashboard, and monitor live policy enforcement decisions from your terminal.

Install

# Run without installing (recommended)
npx qsva-cli init

# Or install globally
npm install -g qsva-cli

Commands

qsva init

Connect to the QSVA server, auto-generate an API key, and save your config to .qsva-config.json.

qsva init
# or point at a self-hosted instance:
qsva init --url https://your-qsva-server.example.com
# overwrite an existing config:
qsva init --force

Creates .qsva-config.json:

{
  "gatewayUrl": "https://qsvainsert.onrender.com/api/gateway",
  "dashboardUrl": "https://qsvainsert.onrender.com",
  "apiKey": "qsva_sk_live_...",
  "createdAt": "2026-04-14T12:00:00.000Z"
}

Keep .qsva-config.json out of version control — add it to your .gitignore.

qsva viz

Open the QSVA dashboard in your browser.

qsva viz
# or with a custom URL:
qsva viz --url https://your-qsva-server.example.com

qsva status

Print a live summary of gateway health and recent policy enforcement decisions. Uses the API key from .qsva-config.json automatically.

qsva status
# disable color output:
qsva status --no-color

Example output:

● QSVA Gateway  https://qsvainsert.onrender.com  42ms

  Recent Policy Checks (last 10)
  ─────────────────────────────────────────────────────────────────────
  ResearchAgent   read    financial data        ✓ ACK     2ms   5s ago
  WriterAgent     write   production databases  ✗ BLOCKED 4ms  12s ago
  ─────────────────────────────────────────────────────────────────────
  2 checks  ·  1 ack  ·  1 blocked

qsva --help

Print all available commands and flags.

Quickstart

# 1. Initialize QSVA in your agent project directory
npx qsva-cli init

# 2. Open the dashboard to configure agents and policies
npx qsva-cli viz

# 3. Wrap your agent with the SDK (see dashboard Connect tab for code)

# 4. Monitor policy checks in real time
npx qsva-cli status

How it works

qsva init connects to the QSVA server at https://qsvainsert.onrender.com, creates an API key scoped to your workspace, and saves it locally. The key is used by:

• The SDK to authenticate agent requests through the policy gateway
• qsva status to fetch your workspace's audit log
• The dashboard (stored in your browser's localStorage) to show your agents, policies, and enforcement events