AISO docs

CLI

Run AISO from any terminal. No signup, no config.

Updated April 20, 2026

@aiso/cli is a Node 18+ command-line interface for the AISO scanner. It wraps the same public API as the web UI and the MCP server.

Install

Run once, no install required:

npx @aiso/cli scan https://example.com

Or install globally:

npm install -g @aiso/cli
aiso scan https://example.com

aiso scan

Default command. Queues a scan, polls until complete, renders the result.

aiso scan https://example.com

Pipe-friendly JSON:

aiso scan https://example.com --json

Example JSON shape (trimmed):

{
  "scanId": "...",
  "url": "https://example.com",
  "score": 72,
  "tier": "visible",
  "runtimeVisibility": 55,
  "enginesUsed": ["anthropic", "openai"],
  "dimensions": [...],
  "issues": [...],
  "resultUrl": "https://aiso.tools/scan/..."
}

Environment variables

AISO_API_URL — override the API base (default https://aiso.tools). Useful for local development against a self-hosted AISO instance.
AISO_TELEMETRY — set to 0, false, or no to disable anonymous CLI telemetry.

Badge in your README

Every domain that scans gets an SVG badge at aiso.tools/api/badge/<domain>. Drop it in your README:

[![AISO Score](https://aiso.tools/api/badge/example.com)](https://aiso.tools/scan/latest)

It auto-updates with your latest score. Running the CLI in CI on every deploy keeps the badge current.

Telemetry

When enabled (the default), the CLI sends a single cli_scan_started event per scan to aiso.tools/api/track. The payload contains only: SHA-256 hash prefix of the URL, CLI version, Node version, platform string. Never the URL itself, never any auth tokens.

Opt out with AISO_TELEMETRY=0. Source is MIT at github.com/aiso-tools/cli.