Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (qsva-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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