Interfaccia a riga di comando

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.

Push tra <1sBinario singolo · nessuna dipendenzaLinux · 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"
✓ inviata · livelli · pulsanti · immagini · invio programmato
Funzionalità

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.

Modalità interattiva

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.

pocketalert ui
Modalità interattiva di Pocket Alert CLI: inbox con anteprima di un messaggio
Inizia subito

Tre passi per la tua prima notifica push

1

Installa la CLI

Usa l'installer a una riga, Homebrew, oppure scarica qui sotto il binario per la tua piattaforma.

2

Autenticati

Esegui pocketalert auth una volta e incolla la tua chiave API. In CI, imposta invece POCKETALERT_API_KEY.

3

Invia la tua prima push

Lancia pocketalert send "Title" "Message" e un attimo dopo il telefono vibra.

Download

Scarica il tuo binario

Scegli piattaforma e architettura: binari già compilati, pronti da copiare nel tuo PATH.

macOS

.tar.gz

Linux

.tar.gz

Windows

.zip

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 | sh

Oppure con Homebrew:

brew install pocketalert/tap/pocketalert

Lo 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@latest

Poi verifica che funzioni con pocketalert version.

Guida rapida

1. Autenticati

pocketalert auth

Prendi 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.png

I 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.py

Ricevi 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 high

Le 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 quota

Ogni 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.

FAQ

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.