CLI

The SignalStack CLI lets you run verifications directly from your terminal — no SDK or API client needed. It is ideal for quick checks, CI/CD pipelines, batch processing, and interactive debugging.

Installation

npm install -g @signalstack/cli

Requires Node.js 18 or later.

Quick setup

Run signalstack init to configure your API key interactively:

signalstack init

This stores your API key in ~/.signalstack/config.json. Alternatively, set the SIGNALSTACK_API_KEY environment variable.

Commands

`verify business`

Verify a business entity across 14+ data sources.

signalstack verify business --name "Acme Corp" --jurisdiction gb --pretty

Option	Description
`--name`	Company name (required)
`--jurisdiction`	ISO country code (e.g. `gb`, `us`)
`--tax-id`	Tax / registration ID
`--address`	Company address
`--pretty`	Pretty-print the JSON output

`verify claim`

Fact-check a claim against knowledge sources.

signalstack verify claim --claim "The Eiffel Tower is located in Berlin" --pretty

Option	Description
`--claim`	The claim to verify (required)
`--context`	Additional context for the verification
`--pretty`	Pretty-print the JSON output

`verify document`

Analyze document authenticity, extract text, and detect tampering.

signalstack verify document --url https://example.com/invoice.pdf --pretty

Option	Description
`--url`	URL of the document to analyze (required)
`--type`	Document type hint (e.g. `invoice`, `contract`)
`--pretty`	Pretty-print the JSON output

`verify media`

Analyze media provenance and synthetic score for images and video.

signalstack verify media --url https://example.com/photo.jpg --pretty

Option	Description
`--url`	URL of the media to analyze (required)
`--pretty`	Pretty-print the JSON output

`init`

Interactively configure your API key and preferences. Stores config in ~/.signalstack/config.json.

signalstack init

`open`

Open the SignalStack dashboard in your default browser.

signalstack open

Global flags

Flag	Description
`--pretty`	Pretty-print JSON output
`--no-color`	Disable colored output
`--help`	Show help for any command

CI/CD usage

In CI/CD environments, set the SIGNALSTACK_API_KEY environment variable and use the --no-interactive flag to skip prompts:

# CI/CD — set SIGNALSTACK_API_KEY as an environment variable
SIGNALSTACK_API_KEY=ssk_live_YOUR_KEY signalstack verify business --name "Acme Corp" --pretty --no-interactive

Output format

All verify commands return the full SignalStack API response as JSON. Use --pretty for human-readable output:

{
  "trust_score": 0.92,
  "verdict": "verified",
  "evidence": [
    {
      "source": "Companies House",
      "match_type": "primary",
      "confidence": 0.95,
      "details": { ... }
    }
  ],
  "latency_ms": 843
}

Config file

The CLI stores configuration at ~/.signalstack/config.json:

{
  "api_key": "ssk_live_abc123",
  "default_format": "pretty"
}

CLI