@voidly/cli

Terminal access to Voidly's censorship intelligence APIs. Check if a domain is blocked anywhere in the world, query 5,300+ documented incidents, view 7-day shutdown forecasts, and more — directly from your shell.

Powered by 19.6M live OONI samples, 10 years of historical measurements, and the Sentinel early-warning model.

Install

# One-off (no install)
npx @voidly/cli check chat.openai.com IR

# Global install
npm install -g @voidly/cli
voidly --help

Requires Node.js 18+. No API key needed for read endpoints.

Quick start

# Is ChatGPT blocked in China?
voidly check chat.openai.com CN

# Compare a domain across multiple countries
voidly check whatsapp.com --countries IR,RU,CN,TR

# Full country censorship summary
voidly summary IR

# Recent incidents
voidly incidents --country RU --limit 10

# One incident in detail
voidly incident IR-2026-0142

# Global censorship index
voidly index

# Topic-specific index (e.g. women's health, news, LGBTQ)
voidly index --topic women-health

# Sentinel risk heatmap
voidly heatmap --min-risk 0.3

# 7-day shutdown forecast
voidly forecast IR

Output modes

| Flag | Behavior | | --- | --- | | (none) | Pretty terminal tables with color | | --json | Raw JSON straight from the API — pipe to jq, save to a file, etc. | | --quiet | One value per line, suitable for shell loops |

# Save raw data
voidly incidents --country IR --json > iran-incidents.json

# Pipe IDs into another command
voidly incidents --quiet | xargs -I {} voidly incident {}

# JSON + jq
voidly forecast RU --json | jq '.forecast_summary.max_risk'

Commands

| Command | Description | | --- | --- | | voidly check <domain> [country] | Check if a domain is accessible (default IR) | | voidly check <domain> --countries IR,RU,CN | Batch check across countries | | voidly summary <country> | Country-wide accessibility summary | | voidly incidents [--country CC] [--limit N] | List recent incidents | | voidly incident <id> | Show one incident (readable ID or hash) | | voidly index [--topic NAME] | Global censorship index, optionally by topic | | voidly heatmap [--min-risk N] | Sentinel global risk heatmap | | voidly forecast <country> | 7-day shutdown-risk forecast with SHAP drivers |

Environment

| Variable | Purpose | | --- | --- | | VOIDLY_API_URL | Override base URL (default https://api.voidly.ai) | | NO_COLOR | Disable ANSI color output |

Use it from AI agents

For Claude / Cursor / Windsurf via the Model Context Protocol:

npx @voidly/mcp-server

83 tools covering everything in this CLI plus agent-relay messaging, incident evidence, ISP risk, election briefings, probe network status, and more.

API documentation

Full reference: https://voidly.ai/api-docs

All endpoints exposed by this CLI are public and CC BY 4.0 licensed.

License

MIT