Interfaz de línea de comandos

Notificaciones push, desde tu terminal.

Envía alertas desde scripts, tareas cron y CI/CD, o explora tu bandeja en una interfaz de terminal a pantalla completa. Un binario estático, cero dependencias.

Push en <1sUn solo binario · sin dependenciasLinux · macOS · WindowsCódigo abierto · 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"
✓ enviado · niveles · botones · imágenes · envío programado
Funciones

Toda la API, a un comando de distancia

Todo lo que hace Pocket Alert, integrado en las herramientas que ya usas: tu shell, tus scripts, tus pipelines.

Modo interactivo

Ejecuta pocketalert ui para abrir una bandeja a pantalla completa: busca, lee, redacta con niveles y botones, y gestiona aplicaciones, dispositivos y webhooks.

Pensada para scripts

Añade notificaciones a cualquier script, Makefile o comando de una línea. Sin navegador ni panel: solo tu shell.

Multiplataforma

Un único binario estático para Linux, macOS (Intel y Apple Silicon) y Windows. Sin runtime ni dependencias.

Hecha para CI/CD

Conecta alertas con GitHub Actions, GitLab CI, Jenkins o cualquier pipeline. Autentícate una vez y envía desde cualquier sitio.

Acceso completo a la API

Niveles de prioridad hasta crítico, botones de acción, imágenes adjuntas y envío programado con --at o --in.

Entérate cuando terminen tus tareas

Envuelve cualquier comando con pocketalert exec y recibe un push con el código de salida, la duración y las últimas líneas de la salida.

Segura por defecto

La clave de API se introduce en un prompt oculto y se guarda con permisos 600, o se pasa como POCKETALERT_API_KEY en CI.

Entrega en menos de un segundo

El push llega a tu teléfono en menos de un segundo. Ideal para scripts de monitorización, despliegues y alertas del sistema.

Modo interactivo

Tu bandeja, en la terminal

Ejecuta pocketalert ui para buscar y leer mensajes, redactar nuevos con niveles, envíos programados y botones de acción, y gestionar aplicaciones, dispositivos y webhooks, sin soltar el teclado.

pocketalert ui
Modo interactivo de la CLI de Pocket Alert: bandeja con vista previa de un mensaje
Empieza ya

Tres pasos hasta tu primer push

1

Instala la CLI

Ejecuta el instalador de una línea, usa Homebrew o descarga el binario para tu plataforma más abajo.

2

Autentícate

Ejecuta pocketalert auth una vez y pega tu clave de API. En CI, define POCKETALERT_API_KEY.

3

Envía tu primer push

Lanza pocketalert send "Title" "Message" y tu teléfono vibrará un instante después.

Descarga

Descarga tu binario

Elige tu plataforma y arquitectura: ya compilado y listo para añadir a tu PATH.

macOS

.tar.gz

Linux

.tar.gz

Windows

.zip

Todas las versiones, checksums y el código fuente en GitHub.

Instalación

Linux / macOS

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

O con Homebrew:

brew install pocketalert/tap/pocketalert

El script comprueba el checksum SHA-256. Para fijar una versión, define POCKETALERT_VERSION=v2.1.0.

Windows

Descomprime el archivo y añade la carpeta con pocketalert.exe a tu variable de entorno PATH.

Go

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

Después, comprueba que funciona ejecutando pocketalert version.

Inicio rápido

1. Autentícate

pocketalert auth

Obtén tu clave de API en Claves de API. Se guarda de forma segura en ~/.pocketalert/config.json.

2. Envía una notificación

pocketalert send "Hello" "It works 🎉"

En CI y contenedores, omite auth y define POCKETALERT_API_KEY.

Ejemplos

Niveles, botones e imágenes

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

Los niveles van de silent a critical. Los tipos de botón son view (abre una URL), http (llama a un webhook) y copy, hasta tres por mensaje.

Envía un mensaje por pipe

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

Programa el envío

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>

Recibe un aviso cuando termine un comando

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

Recibes un push con ✓ o ✗, la duración y las últimas líneas de la salida. El código de salida se conserva, así que exec es seguro en CI y en scripts con set -e.

Vigila un log

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

Las líneas que llegan dentro de --batch (5 s por defecto) se agrupan en un solo push, así que una ráfaga de errores cuesta un solo mensaje de tu cuota diaria.

Scripting

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

Todos los comandos aceptan --json, los errores van a stderr y los códigos de salida son fiables. Las alertas críticas, los botones, las imágenes y el envío programado requieren un plan de pago; en el plan gratuito el mensaje se entrega igualmente y la CLI te indica qué se omitió.

Para ver cada comando y opción (mensajes, aplicaciones, dispositivos, webhooks, formularios y claves de API), consulta la documentación de la CLI completa.

Preguntas frecuentes

Preguntas y respuestas

La CLI de Pocket Alert es una herramienta de línea de comandos de código abierto que envía notificaciones push a tu teléfono desde scripts, tareas cron y CI. Puede envolver un comando y avisarte cuando termina, convertir líneas de log en alertas y gestionar mensajes, aplicaciones, dispositivos, webhooks, formularios y claves de API sin navegador.

Sí. pocketalert ui abre una aplicación a pantalla completa en la terminal: explora y busca en la bandeja, lee mensajes con sus botones de acción, redacta nuevos con nivel, envío programado, imagen y botones, y gestiona mensajes programados, aplicaciones, dispositivos y webhooks. Los mensajes nuevos aparecen solos; pulsa ? para ver todos los atajos.

Tras instalar la CLI, ejecuta pocketalert auth y pega tu clave de API en el prompt. Crea tu clave de API en la página de Claves de API. La CLI la comprueba y la guarda en ~/.pocketalert/config.json. En CI, define POCKETALERT_API_KEY.

La CLI de Pocket Alert está disponible para Linux (AMD64 y ARM64), macOS (Intel y Apple Silicon) y Windows (AMD64). Ofrecemos binarios ya compilados para cada plataforma compatible.

Envía una con pocketalert send "Title" "Message". Añade --level critical, hasta tres botones con --action, una imagen con --image, o prográmala con --at / --in.

Por supuesto: la CLI está hecha para CI/CD. Define POCKETALERT_API_KEY como secreto y llama a pocketalert send, o envuelve un paso con pocketalert exec -- make deploy para recibir su resultado en tu teléfono.

No. El envío, exec, watch y el modo interactivo funcionan en el plan gratuito. El nivel crítico, los botones de acción, las imágenes y el envío programado requieren un plan de pago; en el plan gratuito el mensaje se entrega igualmente y la CLI te indica qué se omitió.

Sí. La CLI guarda tu clave de API en ~/.pocketalert/config.json con permisos de archivo 600, dentro de un directorio de configuración creado con 700. Todo el tráfico va por HTTPS y la clave se envía en la cabecera Token.

Tu terminal ya tiene un canal de notificaciones

Descarga el binario, autentícate una vez y envía tu primer push desde la terminal en menos de un minuto.