OutageDeck CLI

Check the live status of 170+ cloud and SaaS providers from a terminal or CI script. OutageDeck normalizes each vendor's official status feed; it does not replace synthetic monitoring.

Install

brew install outagedeck/tap/outagedeck

With MacPorts:

sudo port install outagedeck

With Hermit on macOS or Linux:

hermit install outagedeck

With binenv on macOS or Linux:

binenv update -d
binenv update -f outagedeck
binenv install outagedeck

With mise:

mise use -g github:outagedeck/cli@0.1.3

With Nix:

nix run github:outagedeck/cli -- --version

From the multi-architecture container image:

docker run --rm ghcr.io/outagedeck/cli:0.1.3 status --fail-on=never github cloudflare

The image runs as a non-root user, has no shell or package manager, and is published for Linux AMD64 and ARM64 with provenance and an SBOM.

In a Dev Container or Codespace, use the published Dev Containers Extra feature:

"features": {
  "ghcr.io/devcontainers-extra/features/outagedeck:1": {}
}

Or launch the repository's ready-to-use configuration with GitHub Codespaces; it installs the current OutageDeck release automatically.

On Windows with WinGet:

winget install --id OutageDeck.CLI --exact

Or with Scoop:

scoop bucket add outagedeck https://github.com/outagedeck/scoop-bucket
scoop install outagedeck

Or install from source:

go install github.com/outagedeck/cli/cmd/outagedeck@latest

Already use GitHub CLI? The companion extension defaults to GitHub provider and service health:

gh extension install outagedeck/gh-outagedeck
gh outagedeck

Release archives for macOS, Linux, and Windows are available on the releases page.

Use

$ outagedeck status aws cloudflare github openai
OK AWS: Operational — All Systems Operational
OK Cloudflare: Operational — All Systems Operational
OK GitHub: Operational — All Systems Operational
!! OpenAI: Degraded — OpenAI reports an active incident

Find a provider slug:

$ outagedeck search "Claude"
anthropic                operational        Anthropic

Turn a checked dependency stack into a prefilled alert setup:

$ outagedeck alerts aws cloudflare github openai
Set up alerts for aws, cloudflare, github, openai:
https://outagedeck.com/account?stack=aws%2Ccloudflare%2Cgithub%2Copenai&utm_campaign=cli_distribution&utm_content=alerts_command&utm_medium=terminal&utm_source=cli

Free email alerts cover up to five providers, and the selected stack survives the email sign-in round trip.

Use structured output in scripts:

outagedeck status --json --fail-on=outage aws github openai

The status command exits with:

• 0 when every provider is below the selected threshold;
• 1 when a request or argument fails;
• 2 when at least one provider meets the selected threshold.

--fail-on accepts degraded (default), outage, major_outage, or never. Set OUTAGEDECK_API_KEY or pass --api-key for a higher API quota.

Data and trust

• Data comes from official vendor status feeds and is refreshed about every 10 minutes.
• An unreachable or malformed response is an error, never operational.
• The public API allows 120 requests per hour. The CLI checks up to 20 providers concurrently.
• No telemetry is added by the CLI. Requests identify the client through a standard User-Agent header.

Review the API documentation or run outagedeck alerts with the providers you want to watch.

License

MIT