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.
# 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"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.
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.

Drei Schritte bis zur ersten Push-Benachrichtigung
CLI installieren
Nutze den Einzeiler-Installer, Homebrew oder lade unten das Binary für deine Plattform herunter.
Authentifizieren
Führe einmal pocketalert auth aus und füge deinen API-Schlüssel ein. In CI setzt du stattdessen POCKETALERT_API_KEY.
Ersten Push senden
Setze pocketalert send "Title" "Message" ab – kurz darauf vibriert dein Handy.
Lade dein Binary herunter
Wähle Plattform und Architektur – vorkompiliert und bereit für deinen PATH.
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 | shOder mit Homebrew:
brew install pocketalert/tap/pocketalertDas 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@latestPrüfe danach mit pocketalert version, ob alles funktioniert.
Schnellstart
1. Authentifizieren
pocketalert authHol 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.pngLevels 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.pyDu 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 highZeilen, 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 quotaJeder 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.
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.