Notifiche push, direttamente dal terminale.
Invia avvisi da script, cron job e CI/CD, oppure sfoglia la tua inbox in una terminal UI a schermo intero. Un solo binario statico, zero dipendenze.
# 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"Tutta l'API, a un comando di distanza
Tutto quello che fa Pocket Alert, integrato negli strumenti che usi ogni giorno: shell, script e pipeline.
Modalità interattiva
Lancia pocketalert ui per un'inbox a schermo intero: cerca, leggi, scrivi messaggi con livelli e pulsanti, e gestisci applicazioni, dispositivi e webhook.
Pensata per gli script
Aggiungi notifiche a qualsiasi script, Makefile o one-liner. Niente browser, niente dashboard: solo la tua shell.
Multipiattaforma
Un solo binario statico per Linux, macOS (Intel e Apple Silicon) e Windows. Nessun runtime, nessuna dipendenza.
Fatta per CI/CD
Collega gli avvisi a GitHub Actions, GitLab CI, Jenkins o qualsiasi pipeline. Ti autentichi una volta e invii ovunque.
Accesso completo all'API
Livelli di priorità fino a critical, pulsanti di azione, immagini allegate e invio programmato con --at o --in.
Sai quando i job finiscono
Esegui qualsiasi comando con pocketalert exec e ricevi una push con exit code, durata e ultime righe di output.
Sicura di default
La chiave API si inserisce in un prompt nascosto e viene salvata con permessi 600, oppure si passa come POCKETALERT_API_KEY in CI.
Consegna in meno di un secondo
La notifica push arriva sul telefono in meno di un secondo. Perfetta per script di monitoraggio, deploy e avvisi di sistema.
La tua inbox, nel terminale
Lancia pocketalert ui per cercare e leggere i messaggi, scriverne di nuovi con livelli, invii programmati e pulsanti di azione, e gestire applicazioni, dispositivi e webhook, senza staccare le mani dalla tastiera.

Tre passi per la tua prima notifica push
Installa la CLI
Usa l'installer a una riga, Homebrew, oppure scarica qui sotto il binario per la tua piattaforma.
Autenticati
Esegui pocketalert auth una volta e incolla la tua chiave API. In CI, imposta invece POCKETALERT_API_KEY.
Invia la tua prima push
Lancia pocketalert send "Title" "Message" e un attimo dopo il telefono vibra.
Scarica il tuo binario
Scegli piattaforma e architettura: binari già compilati, pronti da copiare nel tuo PATH.
Tutte le release, i checksum e il codice sorgente su GitHub.
Installazione
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/PocketAlert/cli/main/install.sh | shOppure con Homebrew:
brew install pocketalert/tap/pocketalertLo script verifica il checksum SHA-256. Per fissare una versione, imposta POCKETALERT_VERSION=v2.1.0.
Windows
Estrai l'archivio e aggiungi la cartella con pocketalert.exe alla variabile d'ambiente PATH.
Go
go install github.com/PocketAlert/cli/cmd/pocketalert@latestPoi verifica che funzioni con pocketalert version.
Guida rapida
1. Autenticati
pocketalert authPrendi la tua chiave API da Chiavi API. Viene salvata in modo sicuro in ~/.pocketalert/config.json.
2. Invia una notifica
pocketalert send "Hello" "It works 🎉"In CI e nei container, salta auth e imposta invece POCKETALERT_API_KEY.
Esempi
Livelli, pulsanti e immagini
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.pngI livelli vanno da silent a critical. I tipi di pulsante sono view (apre un URL), http (chiama un webhook) e copy, fino a tre per messaggio.
Passa il messaggio in pipe
df -h | pocketalert send "Disk report"
pocketalert send -t "AI summary" -m "$SUMMARY" # safe for text that starts with "-"Programma l'invio
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>Ricevi una notifica quando un comando finisce
pocketalert exec -- make release
pocketalert exec --on failure -l critical -- ./backup.sh
pocketalert exec -t "Nightly import" --tail 20 -- python import.pyRicevi una push con ✓ o ✗, la durata e le ultime righe di output. L'exit code viene preservato, quindi exec si può usare tranquillamente in CI e negli script con set -e.
Tieni d'occhio un log
tail -f app.log | grep --line-buffered ERROR | pocketalert watch -t "app errors"
journalctl -fu nginx | pocketalert watch --batch 1m -l highLe righe che arrivano entro --batch (5s di default) vengono raggruppate in un'unica push, così una raffica di errori conta come un solo messaggio nel tuo limite giornaliero.
Scripting
TID=$(pocketalert send "Build" "started" -q) # print only the TID
pocketalert messages list --json | jq -r '.data[].title'
pocketalert usage # today's quotaOgni comando accetta --json, gli errori vanno su stderr e gli exit code sono affidabili. Avvisi critical, pulsanti, immagini e invio programmato richiedono un piano a pagamento; con il piano gratuito il messaggio viene comunque consegnato e la CLI ti dice cosa è stato escluso.
Per tutti i comandi e le opzioni (messaggi, applicazioni, dispositivi, webhook, form e chiavi API) consulta la documentazione della CLI.
Le risposte alle tue domande
Pocket Alert CLI è uno strumento a riga di comando open source per inviare notifiche push al telefono da script, cron job e CI. Può eseguire un comando e avvisarti quando finisce, trasformare le righe di un log in avvisi e gestire messaggi, applicazioni, dispositivi, webhook, form e chiavi API senza browser.
Sì. pocketalert ui apre un'app a schermo intero nel terminale: sfoglia e cerca nell'inbox, leggi i messaggi con i loro pulsanti di azione, scrivine di nuovi con livello, invio programmato, immagine e pulsanti, e gestisci messaggi programmati, applicazioni, dispositivi e webhook. I nuovi messaggi compaiono da soli; premi ? per tutte le scorciatoie.
Dopo aver installato la CLI, esegui pocketalert auth e incolla la tua chiave API quando richiesto. Crea la chiave API nella pagina Chiavi API. La CLI verifica la chiave e poi la salva in ~/.pocketalert/config.json. In CI, imposta invece POCKETALERT_API_KEY.
Pocket Alert CLI è disponibile per Linux (AMD64 e ARM64), macOS (Intel e Apple Silicon) e Windows (AMD64). Per ogni piattaforma supportata trovi binari già compilati.
Usa pocketalert send "Title" "Message". Aggiungi --level critical, fino a tre pulsanti con --action, un'immagine con --image, oppure programma l'invio con --at / --in.
Certo, la CLI è fatta apposta per CI/CD. Imposta POCKETALERT_API_KEY come secret e chiama pocketalert send, oppure esegui uno step con pocketalert exec -- make deploy per ricevere il risultato sul telefono.
No. Invio, exec, watch e modalità interattiva funzionano con il piano gratuito. Il livello critical, i pulsanti di azione, le immagini e l'invio programmato richiedono un piano a pagamento; con il piano gratuito il messaggio viene comunque consegnato e la CLI ti dice cosa è stato escluso.
Sì. La CLI salva la tua chiave API in ~/.pocketalert/config.json con permessi 600, in una cartella di configurazione creata con permessi 700. Tutto il traffico passa su HTTPS e la chiave viene inviata nell'header Token.
Il tuo terminale ha appena guadagnato un canale di notifica
Scarica il binario, autenticati una volta e invia la tua prima notifica push dal terminale in meno di un minuto.