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.