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