Integration

Push CLI

Send push notifications from your terminal, shell scripts, CI/CD pipelines, and AI agents using the Push CLI.

Installation

Homebrew

brew install techulus/tap/push

From source

go install github.com/techulus/push-cli@latest

Or download pre-built binaries from GitHub Releases.

Quick Start

Configure your API key

push config set-key <your-api-key>

Send your first notification

push notify --title "Hello" --body "My first notification"

Pipe output from a command

echo "Build failed on main" | push notify --title "CI Alert"

With all options

push notify \
  --title "Alert" \
  --body "CPU usage above 90%" \
  --sound default \
  --channel monitoring \
  --link "https://grafana.example.com/dashboard" \
  --image "https://example.com/chart.png" \
  --time-sensitive

Using Push CLI with AI Agents

AI agents and coding assistants like Claude Code, Cursor, and Windsurf can use the Push CLI to send you real-time notifications about task progress, errors, and completions. Since the CLI is a simple command-line tool, any agent with shell access can use it without additional setup.

Notify when a long-running task completes

npm run build && push notify --title "Build Complete" --body "Production build finished successfully"

npm test 2>&1 | push notify --title "Test Results"

Alert on deployment status

kubectl rollout status deployment/app && \
  push notify --title "Deploy Success" --body "App deployed to production" --sound correct || \
  push notify --title "Deploy Failed" --body "Rollout failed" --sound fail --time-sensitive

Monitor errors in real-time

tail -f /var/log/app/error.log | while read line; do
  push notify --title "Error Detected" --body "$line" --time-sensitive
done

Add the Push CLI to your agent's toolset and get notified on your phone whenever something important happens — no polling, no browser tabs, just instant push notifications.

Features

Simple Setup: Install via Homebrew, Go, or download a binary. Configure your API key once and start sending notifications immediately.
Pipe from Stdin: Pipe output from any command directly into a notification. Monitor logs, build output, or script results effortlessly.
Async Notifications: Send notifications asynchronously for non-blocking workflows. Perfect for background jobs and CI/CD pipelines.
Group Notifications: Send notifications to a group of devices at once. Ideal for team alerts, on-call rotations, and broadcast messages.
Custom Sounds: Choose from 15 built-in notification sounds to differentiate alerts by type or urgency. From arcade to doorbell, pick what fits.
Rich Notifications: Attach links, images, and channels to your notifications. Mark alerts as time-sensitive to bypass focus modes.

View on GitHub