Interface de linha de comando

Notificações push, direto do seu terminal.

Envie alertas de scripts, tarefas cron e CI/CD, ou navegue pela caixa de entrada em uma interface de terminal em tela cheia. Um único binário estático, zero dependências.

Push em <1sBinário único · sem dependênciasLinux · macOS · WindowsCódigo aberto · 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 · níveis · botões · imagens · envio agendado
Recursos

A API inteira a um comando de distância

Tudo o que o Pocket Alert faz, integrado às ferramentas que você já usa no dia a dia: seu shell, seus scripts, seus pipelines.

Modo interativo

Rode pocketalert ui para abrir a caixa de entrada em tela cheia: pesquise, leia, escreva mensagens com níveis e botões e gerencie aplicativos, dispositivos e webhooks.

Feito para scripts

Coloque notificações em qualquer script, Makefile ou one-liner. Sem navegador, sem painel: só o seu shell.

Multiplataforma

Um único binário estático para Linux, macOS (Intel e Apple Silicon) e Windows. Sem runtime, sem dependências.

Feito para CI/CD

Integre alertas ao GitHub Actions, GitLab CI, Jenkins ou qualquer pipeline. Autentique uma vez e envie de qualquer lugar.

Acesso completo à API

Níveis de prioridade até crítico, botões de ação, imagens anexadas e envio agendado com --at ou --in.

Saiba quando as tarefas terminam

Envolva qualquer comando com pocketalert exec e receba um push com o código de saída, a duração e as últimas linhas da saída.

Seguro por padrão

A chave de API é digitada em um prompt oculto e guardada com permissão 600, ou passada como POCKETALERT_API_KEY no CI.

Entrega em menos de um segundo

O push chega ao seu celular em menos de um segundo. Ideal para scripts de monitoramento, deploys e alertas de sistema.

Modo interativo

Sua caixa de entrada, no terminal

Rode pocketalert ui para pesquisar e ler mensagens, escrever novas com níveis, agendamentos e botões de ação, e gerenciar aplicativos, dispositivos e webhooks, sem tirar as mãos do teclado.

pocketalert ui
Modo interativo da CLI do Pocket Alert: caixa de entrada com prévia de uma mensagem
Primeiros passos

Três passos até o seu primeiro push

1

Instale a CLI

Rode o instalador de uma linha, use o Homebrew ou baixe o binário da sua plataforma abaixo.

2

Autentique

Rode pocketalert auth uma vez e cole sua chave de API. No CI, defina POCKETALERT_API_KEY.

3

Envie seu primeiro push

Dispare pocketalert send "Title" "Message" e seu celular vibra em instantes.

Download

Baixe o seu binário

Escolha sua plataforma e arquitetura: já compilado, pronto para colocar no seu PATH.

macOS

.tar.gz

Linux

.tar.gz

Windows

.zip

Todas as versões, checksums e o código-fonte no GitHub.

Instalação

Linux / macOS

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

Ou com o Homebrew:

brew install pocketalert/tap/pocketalert

O script confere o checksum SHA-256. Para fixar uma versão, defina POCKETALERT_VERSION=v2.1.0.

Windows

Descompacte o arquivo e adicione a pasta com o pocketalert.exe à variável de ambiente PATH.

Go

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

Depois, confirme que funciona rodando pocketalert version.

Primeiros passos

1. Autentique

pocketalert auth

Pegue sua chave de API em Chaves de API. Ela fica guardada com segurança em ~/.pocketalert/config.json.

2. Envie uma notificação

pocketalert send "Hello" "It works 🎉"

No CI e em contêineres, pule o auth e defina POCKETALERT_API_KEY.

Exemplos

Níveis, botões e imagens

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

Os níveis vão de silent a critical. Os tipos de botão são view (abre uma URL), http (chama um webhook) e copy, até três por mensagem.

Envie uma mensagem via pipe

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

Agende o envio

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>

Receba um aviso quando um comando terminar

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

Você recebe um push com ✓ ou ✗, a duração e as últimas linhas da saída. O código de saída é repassado, então o exec é seguro no CI e em scripts com set -e.

Acompanhe um log

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

As linhas que chegam dentro de --batch (5s por padrão) são agrupadas em um único push, então uma rajada de erros consome só uma mensagem do seu limite diário.

Scripts

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

Todo comando aceita --json, os erros vão para o stderr e os códigos de saída são confiáveis. Alertas críticos, botões, imagens e envio agendado exigem um plano pago; no plano gratuito a mensagem é entregue do mesmo jeito e a CLI avisa o que ficou de fora.

Para ver todos os comandos e flags (mensagens, aplicativos, dispositivos, webhooks, formulários e chaves de API), consulte a documentação da CLI.

FAQ

Dúvidas respondidas

A CLI do Pocket Alert é uma ferramenta de linha de comando de código aberto que envia notificações push para o seu celular a partir de scripts, tarefas cron e CI. Ela pode envolver um comando e avisar quando ele terminar, transformar linhas de log em alertas e gerenciar mensagens, aplicativos, dispositivos, webhooks, formulários e chaves de API sem precisar de navegador.

Sim. O pocketalert ui abre um app em tela cheia no terminal: navegue e pesquise na caixa de entrada, leia mensagens com seus botões de ação, escreva novas com nível, agendamento, imagem e botões, e gerencie mensagens agendadas, aplicativos, dispositivos e webhooks. Novas mensagens aparecem sozinhas; aperte ? para ver todos os atalhos.

Depois de instalar a CLI, rode pocketalert auth e cole sua chave de API no prompt. Crie sua chave de API na página Chaves de API. A CLI valida a chave e a guarda em ~/.pocketalert/config.json. No CI, defina POCKETALERT_API_KEY.

A CLI do Pocket Alert está disponível para Linux (AMD64 e ARM64), macOS (Intel e Apple Silicon) e Windows (AMD64). Há binários prontos para todas as plataformas compatíveis.

Envie com pocketalert send "Title" "Message". Adicione --level critical, até três botões com --action, uma --image, ou agende com --at / --in.

Com certeza, a CLI foi feita para CI/CD. Defina POCKETALERT_API_KEY como secret e chame pocketalert send, ou envolva uma etapa com pocketalert exec -- make deploy para receber o resultado no celular.

Não. O envio, o exec, o watch e o modo interativo funcionam no plano gratuito. O nível crítico, os botões de ação, as imagens e o envio agendado exigem um plano pago; no plano gratuito a mensagem é entregue do mesmo jeito e a CLI avisa o que ficou de fora.

Sim. A CLI guarda sua chave de API em ~/.pocketalert/config.json com permissão de arquivo 600, dentro de um diretório de configuração criado com 700. Todo o tráfego passa por HTTPS e a chave é enviada no header Token.

Seu terminal ganhou um canal de notificações

Baixe o binário, autentique uma vez e envie seu primeiro push pelo terminal em menos de um minuto.