CLI commands

CLI commands

Every command and flag, generated from the CLI itself.

Every command and flag of the ValiqAI CLI. Each command also prints its own with --help.

Generated from the CLI 1.9.2 itself, so it matches valiqai <command> --help.

CommandWhat it does
valiqai scanScan a URL, wait for the result, and exit non-zero when it finds problems
valiqai scans listRecent scans, newest first
valiqai scans viewA scan: its status, score and problems by severity
valiqai scans watchFollow a scan until it ends, like valiqai scan does, with the same exit codes
valiqai scans cancelStop a scan that is still running (unused credits come back)
valiqai problemsA scan's problems, worst first, with the pages each was found on
valiqai domains listYour domains and whether each is verified
valiqai domains addAdd a domain to verify and print the TXT record to add
valiqai domains verifyCheck the TXT record now (at most every 30 seconds)
valiqai domains removeStop verifying a domain; scans of it are refused after
valiqai creditsThe workspace's credits, and what each scan reserves
valiqai openOpen ValiqAI in your browser: a scan, a domain, or this folder's site
valiqai loginSign in from your browser (in CI, set VALIQAI_API_KEY instead)
valiqai logoutSign out of the active workspace (--all for every one); browser sign-ins also revoke their key
valiqai whoamiShow who you are signed in as, the workspace, and the key commands will use
valiqai switchChange the active workspace, or sign in to another one
valiqai linkTie this folder to a site, so valiqai scan needs no URL here (writes valiqai.json)
valiqai initAdd a CI job that scans your site and fails the build on blockers
valiqai doctorCheck your setup: Node, the key, ValiqAI, valiqai.json, the domain, credits
valiqai completionPrint a tab-completion script for your shell: bash, zsh, fish or powershell
valiqai mcpRun an MCP server on stdio, so AI coding tools can start scans and read problems
valiqai config getPrint one setting (apiKey, apiUrl, defaultMode or timeout)
valiqai config setChange a setting (apiUrl, defaultMode or timeout)
valiqai config listShow every setting
valiqai config pathPrint where settings are saved
valiqai config resetRemove the saved key and every saved setting

Options for every command

OptionWhat it does
-V, --versionoutput the version number
--no-colorNo colours (NO_COLOR does the same)
-q, --quietPrint only the result: no progress (scan, scans watch)
--debugPrint each request to ValiqAI, its status, time and request id (the key masked)