Kembali ke Blog

Pocket Alert CLI 2.1: level, exec, watch dan inbox di terminal Anda

Pocket Alert CLI 2.1: level, exec, watch dan inbox di terminal Anda

CLI Pocket Alert yang pertama hanya bisa mengirim judul dan pesan. Itu cukup untuk membuktikan ide ini, tidak lebih: tidak ada level prioritas, tidak ada tombol, tidak ada penjadwalan, dan tidak ada fitur untuk tugas yang paling umum, yaitu memberi tahu Anda saat perintah yang lama selesai.

Versi 2 adalah penulisan ulang. Kode-nya berada di repositori tersendiri di bawah lisensi MIT, dipasang dengan satu perintah, dan mencakup semua yang bisa dilakukan API. Versi 2.1, yang dirilis hari ini, menambahkan pocketalert ui: aplikasi terminal layar penuh untuk inbox, pesan terjadwal, aplikasi, perangkat, dan webhook Anda.

Inbox CLI Pocket Alert di terminal

Instalasi

macOS dan Linux:

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

Homebrew:

brew install pocketalert/tap/pocketalert

Go:

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

Windows: unduh pocketalert_windows_amd64.zip dari rilis terbaru dan letakkan pocketalert.exe di PATH Anda. Setiap rilis menyertakan arsip untuk macOS dan Linux (Intel dan ARM) serta Windows (x64), lengkap dengan checksum.

Lalu masuk sekali dengan kunci API dari Kunci API:

pocketalert auth

Kunci dimasukkan pada prompt tersembunyi, diperiksa ke API, dan disimpan di ~/.pocketalert/config.json dengan mode 600. Di CI, atur POCKETALERT_API_KEY sebagai gantinya; variabel ini lebih diutamakan daripada kunci yang tersimpan.

Kirim, dengan semua yang ditawarkan API

Bentuk dasarnya kini hanya dua argumen:

pocketalert send "Deploy finished" "v1.4.2 is live"

Pesan bisa berasal dari stdin, sehingga output perintah langsung terkirim ke ponsel Anda:

df -h | pocketalert send "Disk report"

Opsi lainnya berupa flag:

  • Level. -l silent|low|default|high|critical, atau -2 sampai 2. critical tetap lolos dari Jangan Ganggu pada paket berbayar; paket gratis menerimanya sebagai high.
  • Penjadwalan. --at "2026-10-20 09:50" sesuai zona waktu akun Anda, atau --in 1d12h. Hingga 30 hari ke depan, pada paket berbayar. pocketalert scheduled list dan scheduled cancel <tid> mengelola antrean.
  • Tombol aksi. Hingga tiga --action type:label:value, dengan type view, http, atau copy. Pada paket berbayar.
  • Gambar. --image ./screenshot.png atau URL https://. Pada paket berbayar.
  • Target. -a untuk aplikasi, -d untuk satu perangkat.
  • Scripting. -q hanya menampilkan ID pesan, dan setiap perintah menerima --json untuk respons API mentah.

Contoh deploy yang gagal dengan semua opsi sekaligus:

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"

Tombol http mengirim POST secara default. Tulis http:Ack:GET https://… untuk metode lain, atau gunakan bentuk JSON lengkap dengan header dan body.

exec: push saat perintah berakhir

Fitur yang dulu ditulis orang lewat skrip pembungkus kini sudah tersedia. exec menjalankan perintah, menampilkan output seperti biasa, dan mengirim push saat perintah berakhir:

pocketalert exec -- ./backup.sh

Judul push berupa perintah dengan ✓, atau ✗ beserta kode keluarnya. Isinya memuat durasi, nama host, dan sepuluh baris terakhir output. Kegagalan dikirim dengan level high kecuali Anda menentukan level lain, dan kode keluar perintah diteruskan apa adanya, sehingga exec aman digunakan di skrip, cron, dan CI.

pocketalert exec --on failure -l critical -- terraform apply -auto-approve
pocketalert exec -t "Nightly import" --tail 20 -- python import.py

--on menentukan kapan notifikasi dikirim: always, success, atau failure. --tail menentukan jumlah baris output yang disertakan, atau 0 jika tidak ada.

watch: baris log sebagai push

watch membaca baris dari pipe dan mengirimkannya sebagai notifikasi:

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

Baris yang masuk dalam jendela batch, lima detik secara default, dikelompokkan menjadi satu push dengan jumlah baris di judulnya. Lonjakan dua ratus error hanya memakai satu pesan dari kuota harian Anda, bukan dua ratus.

pocketalert ui

Jalankan pocketalert ui dan terminal Anda menjadi klien Pocket Alert. Ada lima tab, berpindah dengan tab atau 1 sampai 5: Inbox, Terjadwal, Aplikasi, Perangkat, dan Webhook.

Inbox menampilkan pesan beserta level, aplikasi, dan waktunya, dengan pesan yang belum dibaca ditandai titik. Panel di sebelah kanan menampilkan pesan yang dipilih secara lengkap, termasuk tombol aksi dan targetnya. Cari dengan /, tampilkan hanya yang belum dibaca dengan u, tandai satu pesan sudah dibaca dengan r atau semuanya dengan a. Pesan baru muncul sendiri selama aplikasi terbuka.

Pesan dengan tombol aksi di panel pratinjau

n membuka composer: judul dan pesan, lalu aplikasi, perangkat, level, waktu pengiriman, gambar, dan hingga tiga tombol aksi, masing-masing dalam bentuk type:label:value yang sama seperti flag send. ctrl+s untuk mengirim. f pada pesan yang sudah ada akan membukanya kembali di composer, untuk dikirim ulang atau dijadikan templat.

Menyusun pesan baru di terminal

Tab lainnya mengelola bagian akun yang lain. Aplikasi menampilkan setiap aplikasi beserta level default-nya; buat, ganti nama, ubah level, atau hapus tanpa meninggalkan keyboard, dan tekan enter untuk melihat pesan dari aplikasi tersebut. Perangkat mencantumkan ponsel Anda dan memungkinkan Anda mengganti nama atau menghapusnya. Webhook mencantumkan webhook Anda beserta riwayat permintaannya, dan y menyalin URL webhook. Terjadwal menampilkan apa saja yang masih antre dan membatalkannya dengan d.

Aplikasi di antarmuka terminal

Setiap tindakan yang bersifat merusak akan meminta konfirmasi terlebih dahulu, dan ? menampilkan semua pintasan.

Mengelola akun dari skrip

Bagian lain dari API juga tercakup, dan setiap perintah menerima --json:

pocketalert usage                                   # today's quota
pocketalert messages list -n 20
pocketalert messages read --all
pocketalert apps create -n "Production" -c "#EF4444" -l high
pocketalert webhooks create -n Grafana -m "%title%: %message%" -l high
pocketalert webhooks history <tid> --status error
pocketalert devices rename <tid> "Work phone"

Dari CLI, Anda kini dapat mengatur level default untuk aplikasi dan webhook, serta tombol aksi pada webhook dengan placeholder %field.path% yang diisi dari payload, sehingga peringatan Grafana bisa tiba sebagai high dengan tombol yang langsung membuka panel tersebut.

Autocomplete shell untuk zsh, bash, dan fish tersedia lewat pocketalert completion.

Upgrade dari 1.x

Pasang 2.1 dengan salah satu metode di atas; versi ini menggantikan binary lama dan tetap menyimpan kunci Anda. Tiga perubahan mungkin berdampak pada skrip yang sudah ada:

  • Pesan kini wajib. pocketalert send -t "Cron OK" tanpa -m akan mengembalikan error. Tambahkan pesan, alirkan dari pipe, atau gunakan exec, yang akan membuatnya untuk Anda.
  • Jangan campur bentuk. Gunakan salah satu: send "Title" "Message" atau send -t "Title" -m "Message". send -t "Title" "Message" akan membaca argumen kedua sebagai judul dan berhenti.
  • Utamakan -m untuk teks yang dihasilkan. Pesan posisional yang diawali tanda hubung, misalnya daftar Markdown dari agen AI, akan dibaca sebagai opsi. -m "$text" selalu aman.

Nama arsip rilis kini berformat pocketalert_<os>_<arch>.tar.gz, dan .zip di Windows, jika Anda mengunduhnya dalam skrip provisioning.

Beberapa bug dari 1.x juga sudah diperbaiki: webhooks create kini menghormati --application dan --device, URL webhook mengarah ke host yang benar, error dikirim ke stderr alih-alih stdout, judul non-Latin tidak lagi terpotong di tengah karakter, dan saat batas harian tercapai, Anda akan melihat penggunaan dan waktu reset alih-alih sekadar 429.

Posisinya di mana

CLI kini menjadi jalur terpendek dari terminal ke ponsel Anda, dan panduan di blog ini memakainya di tempat yang menghemat baris kode. Untuk coding agent, skrip hook pada panduan Claude Code, Codex, dan Cline dan Aider dapat memanggil pocketalert send alih-alih curl. Untuk cron dan CI, exec menggantikan sebagian besar one-liner || curl.

Pasang CLI, jalankan pocketalert auth, lalu coba pocketalert ui.

Bagikan artikel ini