CLI v1 Send notifications from your terminal

Updated 7 April 2026 — Linux support now available via apt and dnf.

The API Alerts CLI is here. You can now send notifications directly from your terminal, shell scripts, and cron jobs — no SDK, no code, just a single command.

apialerts send --channel deploys --message "Build complete"

Installation

macOS (Homebrew)

brew install apialerts/tap/apialerts

Windows (Scoop)

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

Debian / Ubuntu (apt)

curl -fsSL https://apt.apialerts.com/key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/apialerts.gpg
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/apialerts.gpg] https://apt.apialerts.com stable main" | sudo tee /etc/apt/sources.list.d/apialerts.list
sudo apt update && sudo apt install apialerts

Prefer not to add a repository? .deb and .rpm packages are available on the GitHub Releases page for direct install.

Fedora / RHEL (dnf)

sudo rpm --import https://rpm.apialerts.com/key.gpg
sudo tee /etc/yum.repos.d/apialerts.repo <<EOF
[apialerts]
name=API Alerts
baseurl=https://rpm.apialerts.com
enabled=1
gpgcheck=1
gpgkey=https://rpm.apialerts.com/key.gpg
EOF
sudo dnf install apialerts

What it’s good for

The CLI is designed for the places where pulling in an SDK would be overkill — cron jobs that need a nudge when they finish, CI pipelines that should ping your phone on failure, or quick one-off notifications while debugging.

# Notify on cron completion
0 3 * * * /usr/local/bin/backup.sh && apialerts send --channel ops --message "Nightly backup complete"

# Notify on deploy failure in a shell script
npm run build || apialerts send --channel deploys --message "Build failed on $(hostname)"

See the full CLI documentation for all flags and setup options, or view the source on GitHub.