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 — initialize your workspace, open the visualization dashboard, and monitor policy enforcement decisions directly from your terminal.

Install

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

# Or install globally
npm install -g qsva-cli

Commands

`qsva init`

Initialize QSVA in your current directory. Connects to a running QSVA server, auto-generates an API key, and saves your config to .qsva-config.json.

qsva init
# or with a custom gateway URL:
qsva init --url http://my-qsva-server.example.com
# overwrite an existing config:
qsva init --force

Creates .qsva-config.json:

{
  "gatewayUrl": "http://localhost:3000/api/gateway",
  "dashboardUrl": "http://localhost:3000",
  "apiKey": "qsva_sk_live_...",
  "createdAt": "2026-04-09T12: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. Reads the dashboard URL from .qsva-config.json or falls back to http://localhost:3000.

qsva viz
# or with a custom URL:
qsva viz --url http://localhost:3000

`qsva status`

Print a live summary of gateway health and recent policy enforcement decisions.

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

Example output:

● QSVA Gateway  http://localhost:3000  2ms

  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.

Prerequisites

The QSVA server must be running before you use init, viz, or status. Start it with:

cd qsva-intersection
npm run dev

Quickstart

# 1. Start the QSVA server
cd qsva-intersection && npm run dev

# 2. In your agent project directory, initialize QSVA
npx qsva-cli init

# 3. Open the dashboard
npx qsva-cli viz

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