Kommandozeile

Push-Benachrichtigungen, direkt aus deinem Terminal.

Sende Alerts aus Skripten, Cronjobs und CI/CD oder durchsuche deinen Posteingang in einer Vollbild-Terminal-UI. Ein statisches Binary, keine Abhängigkeiten.

Push in <1sEinzelnes Binary · keine AbhängigkeitenLinux · macOS · WindowsOpen Source · MIT
# Fire a notification from anywhere
pocketalert send "Deploy finished" "v2.4.0 is live 🚀"
✓ Sent

# Critical alert with buttons — gets through Do Not Disturb
pocketalert send "Deploy failed" "main@4f2c" -l critical \
  --action "view:Open logs:https://ci.example.com/run/1" \
  --action "http:Retry:https://ci.example.com/run/1/retry"
✓ gesendet · Levels · Buttons · Bilder · geplanter Versand
Funktionen

Die ganze API, nur einen Befehl entfernt

Alles, was Pocket Alert kann, eingebunden in die Tools, in denen du ohnehin arbeitest – deine Shell, deine Skripte, deine Pipelines.

Interaktiver Modus

Starte pocketalert ui für einen Vollbild-Posteingang: suchen, lesen, Nachrichten mit Levels und Buttons verfassen und Anwendungen, Geräte und Webhooks verwalten.

Für Skripte gemacht

Baue Benachrichtigungen in jedes Skript, Makefile oder jeden Einzeiler ein. Kein Browser, kein Dashboard – nur deine Shell.

Plattformübergreifend

Ein statisches Binary für Linux, macOS (Intel & Apple Silicon) und Windows. Keine Runtime, keine Abhängigkeiten.

Gebaut für CI/CD

Binde Alerts in GitHub Actions, GitLab CI, Jenkins oder jede andere Pipeline ein. Einmal authentifizieren, überall senden.

Voller API-Zugriff

Prioritätsstufen bis critical, Aktionsbuttons, Bildanhänge und geplanter Versand mit --at oder --in.

Wissen, wann Jobs fertig sind

Umhülle jeden Befehl mit pocketalert exec und erhalte einen Push mit Exit-Code, Dauer und den letzten Ausgabezeilen.

Standardmäßig sicher

Der API-Schlüssel wird in einer verdeckten Eingabe abgefragt und mit Rechten 600 gespeichert – oder in CI als POCKETALERT_API_KEY übergeben.

Zustellung in unter einer Sekunde

Der Push erreicht dein Handy in unter einer Sekunde. Perfekt für Monitoring-Skripte, Deployments und System-Alerts.

Interaktiver Modus

Dein Posteingang im Terminal

Starte pocketalert ui, um Nachrichten zu durchsuchen und zu lesen, neue mit Levels, Zeitplänen und Aktionsbuttons zu verfassen und Anwendungen, Geräte und Webhooks zu verwalten – ohne die Tastatur zu verlassen.

pocketalert ui
Pocket Alert CLI im interaktiven Modus: Posteingang mit Nachrichtenvorschau
Los geht's

Drei Schritte bis zur ersten Push-Benachrichtigung

1

CLI installieren

Nutze den Einzeiler-Installer, Homebrew oder lade unten das Binary für deine Plattform herunter.

2

Authentifizieren

Führe einmal pocketalert auth aus und füge deinen API-Schlüssel ein. In CI setzt du stattdessen POCKETALERT_API_KEY.

3

Ersten Push senden

Setze pocketalert send "Title" "Message" ab – kurz darauf vibriert dein Handy.

Download

Lade dein Binary herunter

Wähle Plattform und Architektur – vorkompiliert und bereit für deinen PATH.

macOS

.tar.gz

Linux

.tar.gz

Windows

.zip

Alle Releases, Prüfsummen und den Quellcode findest du auf GitHub.

Installation

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/PocketAlert/cli/main/install.sh | sh

Oder mit Homebrew:

brew install pocketalert/tap/pocketalert

Das Skript prüft die SHA-256-Prüfsumme. Um eine Version festzulegen, setze POCKETALERT_VERSION=v2.1.0.

Windows

Entpacke das Archiv und füge den Ordner mit pocketalert.exe deiner PATH-Umgebungsvariable hinzu.

Go

go install github.com/PocketAlert/cli/cmd/pocketalert@latest

Prüfe danach mit pocketalert version, ob alles funktioniert.

Schnellstart

1. Authentifizieren

pocketalert auth

Hol dir deinen API-Schlüssel unter API-Schlüssel. Er wird sicher in ~/.pocketalert/config.json gespeichert.

2. Benachrichtigung senden

pocketalert send "Hello" "It works 🎉"

In CI und Containern überspringst du auth und setzt stattdessen POCKETALERT_API_KEY.

Beispiele

Levels, Buttons und Bilder

pocketalert send "Disk 95%" "/var is almost full" --level high
pocketalert send "Deploy failed" "main@4f2c" -l critical \
  --action "view:Open logs:https://ci.example.com/run/1" \
  --action "http:Retry:https://ci.example.com/run/1/retry" \
  --action "copy:Copy SHA:4f2c9e1"
pocketalert send "Grafana" "CPU spike" --image ./panel.png

Levels reichen von silent bis critical. Es gibt die Button-Typen view (URL öffnen), http (Webhook aufrufen) und copy, bis zu drei pro Nachricht.

Nachricht per Pipe übergeben

df -h | pocketalert send "Disk report"
pocketalert send -t "AI summary" -m "$SUMMARY"      # safe for text that starts with "-"

Versand planen

pocketalert send "Standup" "In 10 minutes" --at "2026-10-20 09:50"
pocketalert send "Reminder" "Rotate the keys" --in 1d12h
pocketalert scheduled list
pocketalert scheduled cancel <tid>

Benachrichtigt werden, wenn ein Befehl fertig ist

pocketalert exec -- make release
pocketalert exec --on failure -l critical -- ./backup.sh
pocketalert exec -t "Nightly import" --tail 20 -- python import.py

Du bekommst einen Push mit ✓ oder ✗, der Dauer und den letzten Ausgabezeilen. Der Exit-Code wird durchgereicht, deshalb ist exec in CI und in set -e-Skripten unbedenklich.

Ein Log überwachen

tail -f app.log | grep --line-buffered ERROR | pocketalert watch -t "app errors"
journalctl -fu nginx | pocketalert watch --batch 1m -l high

Zeilen, die innerhalb von --batch (standardmäßig 5s) eintreffen, werden zu einem Push gebündelt. So kostet ein Schwall von Fehlern nur eine Nachricht deines Tageslimits.

Skripting

TID=$(pocketalert send "Build" "started" -q)       # print only the TID
pocketalert messages list --json | jq -r '.data[].title'
pocketalert usage                                   # today's quota

Jeder Befehl akzeptiert --json, Fehler gehen an stderr und die Exit-Codes sind verlässlich. Kritische Alerts, Buttons, Bilder und geplanter Versand erfordern einen kostenpflichtigen Tarif; im kostenlosen Tarif wird die Nachricht trotzdem zugestellt und die CLI sagt dir, was weggelassen wurde.

Alle Befehle und Flags – Nachrichten, Anwendungen, Geräte, Webhooks, Formulare und API-Schlüssel – findest du in der vollständigen CLI-Dokumentation.

FAQ

Fragen und Antworten

Die Pocket Alert CLI ist ein Open-Source-Kommandozeilen-Tool, das Push-Benachrichtigungen aus Skripten, Cronjobs und CI auf dein Handy sendet. Sie kann einen Befehl umhüllen und melden, wenn er fertig ist, Logzeilen in Alerts verwandeln und Nachrichten, Anwendungen, Geräte, Webhooks, Formulare und API-Schlüssel ohne Browser verwalten.

Ja. pocketalert ui öffnet eine Vollbild-App im Terminal: Posteingang durchblättern und durchsuchen, Nachrichten samt Aktionsbuttons lesen, neue mit Level, Zeitplan, Bild und Buttons verfassen sowie geplante Nachrichten, Anwendungen, Geräte und Webhooks verwalten. Neue Nachrichten erscheinen automatisch; mit ? siehst du alle Shortcuts.

Führe nach der Installation pocketalert auth aus und füge deinen API-Schlüssel an der Eingabeaufforderung ein. Du erstellst ihn auf der Seite „API-Schlüssel“. Die CLI prüft den Schlüssel und speichert ihn dann in ~/.pocketalert/config.json. In CI setzt du stattdessen POCKETALERT_API_KEY.

Die Pocket Alert CLI gibt es für Linux (AMD64 und ARM64), macOS (Intel und Apple Silicon) und Windows (AMD64). Für jede unterstützte Plattform gibt es vorkompilierte Binaries.

Mit pocketalert send "Title" "Message". Ergänze --level critical, bis zu drei --action-Buttons, ein --image oder plane den Versand mit --at / --in.

Unbedingt – die CLI ist für CI/CD gebaut. Setze POCKETALERT_API_KEY als Secret und rufe pocketalert send auf, oder umhülle einen Schritt mit pocketalert exec -- make deploy, um das Ergebnis auf dein Handy zu bekommen.

Nein. Senden, exec, watch und der interaktive Modus funktionieren im kostenlosen Tarif. Das Level critical, Aktionsbuttons, Bilder und geplanter Versand erfordern einen kostenpflichtigen Tarif; im kostenlosen Tarif wird die Nachricht trotzdem zugestellt und die CLI sagt dir, was weggelassen wurde.

Ja. Die CLI speichert deinen API-Schlüssel in ~/.pocketalert/config.json mit den Dateirechten 600, in einem Konfigurationsverzeichnis mit 700. Der gesamte Datenverkehr läuft über HTTPS, und der Schlüssel wird im Token-Header gesendet.

Dein Terminal hat jetzt einen Benachrichtigungskanal

Lade das Binary herunter, authentifiziere dich einmal und sende in unter einer Minute deine erste Push-Benachrichtigung aus dem Terminal.