Des notifications push, depuis votre terminal.
Envoyez des alertes depuis vos scripts, tâches cron et pipelines CI/CD, ou parcourez votre boîte de réception dans une interface de terminal plein écran. Un seul binaire statique, aucune dépendance.
# 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"Toute l’API, à une commande
Tout ce que fait Pocket Alert, intégré aux outils que vous utilisez déjà : votre shell, vos scripts, vos pipelines.
Mode interactif
Lancez pocketalert ui pour une boîte de réception plein écran : recherchez, lisez, rédigez avec niveaux et boutons, et gérez applications, appareils et webhooks.
Conçu pour les scripts
Ajoutez des notifications à n’importe quel script, Makefile ou one-liner. Pas de navigateur, pas de tableau de bord : juste votre shell.
Multiplateforme
Un seul binaire statique pour Linux, macOS (Intel et Apple Silicon) et Windows. Aucun runtime, aucune dépendance.
Pensé pour la CI/CD
Branchez des alertes sur GitHub Actions, GitLab CI, Jenkins ou tout autre pipeline. Authentifiez-vous une fois, envoyez partout.
Accès complet à l’API
Niveaux de priorité jusqu’à critical, boutons d’action, images jointes et envoi programmé avec --at ou --in.
Sachez quand vos tâches se terminent
Encapsulez n’importe quelle commande avec pocketalert exec et recevez une notification push avec le code de sortie, la durée et les dernières lignes de sortie.
Sécurisé par défaut
Clé API saisie dans une invite masquée, stockée avec les permissions 600, ou transmise via POCKETALERT_API_KEY en CI.
Livraison en moins d’une seconde
La notification push arrive sur votre téléphone en moins d’une seconde. Idéal pour vos scripts de supervision, déploiements et alertes système.
Votre boîte de réception, dans le terminal
Lancez pocketalert ui pour rechercher et lire des messages, en rédiger de nouveaux avec niveaux, programmation et boutons d’action, et gérer applications, appareils et webhooks, sans quitter le clavier.

Trois étapes jusqu’à votre première notification push
Installez la CLI
Lancez l’installeur en une ligne, utilisez Homebrew ou téléchargez le binaire pour votre plateforme ci-dessous.
Authentifiez-vous
Lancez pocketalert auth une fois et collez votre clé API. En CI, définissez plutôt POCKETALERT_API_KEY.
Envoyez votre première notification push
Lancez pocketalert send "Title" "Message" : votre téléphone vibre un instant plus tard.
Téléchargez votre binaire
Choisissez votre plateforme et votre architecture : binaires précompilés, prêts à placer dans votre PATH.
Toutes les versions, sommes de contrôle et le code source sont sur GitHub.
Installation
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/PocketAlert/cli/main/install.sh | shOu avec Homebrew :
brew install pocketalert/tap/pocketalertLe script vérifie la somme de contrôle SHA-256. Pour figer une version, définissez POCKETALERT_VERSION=v2.1.0.
Windows
Décompressez l’archive et ajoutez le dossier contenant pocketalert.exe à votre variable d’environnement PATH.
Go
go install github.com/PocketAlert/cli/cmd/pocketalert@latestVérifiez ensuite que tout fonctionne en lançant pocketalert version.
Démarrage rapide
1. Authentifiez-vous
pocketalert authRécupérez votre clé API sur la page Clés API. Elle est stockée de façon sécurisée dans ~/.pocketalert/config.json.
2. Envoyez une notification
pocketalert send "Hello" "It works 🎉"En CI et dans les conteneurs, ignorez auth et définissez plutôt POCKETALERT_API_KEY.
Exemples
Niveaux, boutons et images
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.pngLes niveaux vont de silent à critical. Les types de boutons sont view (ouvrir une URL), http (appeler un webhook) et copy, jusqu’à trois par message.
Envoyer un message via un pipe
df -h | pocketalert send "Disk report"
pocketalert send -t "AI summary" -m "$SUMMARY" # safe for text that starts with "-"Programmer l’envoi
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>Être prévenu à la fin d’une commande
pocketalert exec -- make release
pocketalert exec --on failure -l critical -- ./backup.sh
pocketalert exec -t "Nightly import" --tail 20 -- python import.pyVous recevez une notification push avec ✓ ou ✗, la durée et les dernières lignes de sortie. Le code de sortie est transmis : exec est donc sans risque en CI et dans les scripts avec set -e.
Surveiller un journal
tail -f app.log | grep --line-buffered ERROR | pocketalert watch -t "app errors"
journalctl -fu nginx | pocketalert watch --batch 1m -l highLes lignes qui arrivent dans la fenêtre --batch (5 s par défaut) sont regroupées en une seule notification push : une rafale d’erreurs ne coûte qu’un message sur votre quota quotidien.
Scripts
TID=$(pocketalert send "Build" "started" -q) # print only the TID
pocketalert messages list --json | jq -r '.data[].title'
pocketalert usage # today's quotaChaque commande accepte --json, les erreurs vont sur stderr et les codes de sortie sont fiables. Les alertes critiques, les boutons, les images et l’envoi programmé nécessitent une offre payante ; avec l’offre gratuite, le message est tout de même livré et la CLI vous indique ce qui a été omis.
Pour toutes les commandes et options (messages, applications, appareils, webhooks, formulaires et clés API), consultez la documentation de la CLI.
Vos questions, nos réponses
La CLI Pocket Alert est un outil en ligne de commande open source qui envoie des notifications push sur votre téléphone depuis vos scripts, tâches cron et CI. Elle peut encapsuler une commande et signaler sa fin, transformer des lignes de journal en alertes, et gérer messages, applications, appareils, webhooks, formulaires et clés API sans navigateur.
Oui. pocketalert ui ouvre une application plein écran dans le terminal : parcourez et recherchez dans la boîte de réception, lisez les messages avec leurs boutons d’action, rédigez-en de nouveaux avec niveau, programmation, image et boutons, et gérez les messages programmés, les applications, les appareils et les webhooks. Les nouveaux messages apparaissent automatiquement ; appuyez sur ? pour voir tous les raccourcis.
Après avoir installé la CLI, lancez pocketalert auth et collez votre clé API à l’invite. Créez votre clé API sur la page Clés API. La CLI vérifie la clé, puis la stocke dans ~/.pocketalert/config.json. En CI, définissez plutôt POCKETALERT_API_KEY.
La CLI Pocket Alert est disponible pour Linux (AMD64 et ARM64), macOS (Intel et Apple Silicon) et Windows (AMD64). Des binaires précompilés sont fournis pour chaque plateforme prise en charge.
Envoyez-en une avec pocketalert send "Title" "Message". Ajoutez --level critical, jusqu’à trois boutons --action, une --image, ou programmez l’envoi avec --at / --in.
Absolument : la CLI est conçue pour la CI/CD. Définissez POCKETALERT_API_KEY comme secret et appelez pocketalert send, ou encapsulez une étape avec pocketalert exec -- make deploy pour recevoir son résultat sur votre téléphone.
Non. L’envoi, exec, watch et le mode interactif fonctionnent avec l’offre gratuite. Le niveau critical, les boutons d’action, les images et l’envoi programmé nécessitent une offre payante ; avec l’offre gratuite, le message est tout de même livré et la CLI vous indique ce qui a été omis.
Oui. La CLI stocke votre clé API dans ~/.pocketalert/config.json avec les permissions de fichier 600, dans un répertoire de configuration créé avec les permissions 700. Tout le trafic passe par HTTPS et la clé est envoyée dans l’en-tête Token.
Votre terminal dispose désormais d’un canal de notification
Téléchargez le binaire, authentifiez-vous une fois et envoyez votre première notification push depuis le terminal en moins d’une minute.