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

> CLI Pocket Alert ditulis ulang dan bersifat open source. Kirim push notification dengan level, tombol, gambar, dan jadwal; bungkus perintah apa pun dengan exec; ubah baris log menjadi notifikasi dengan watch; dan telusuri semuanya di antarmuka terminal layar penuh.

*17.10.2026*

<!-- source: https://pocketalert.app/id/blog/pocketalert-cli-2 -->

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](https://cdn.pocketalert.app/blog/pocketalert-cli-2-inbox.jpg)

## Instalasi

**macOS dan Linux:**

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

**Homebrew:**

```bash
brew install pocketalert/tap/pocketalert
```

**Go:**

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

**Windows:** unduh [pocketalert_windows_amd64.zip](https://github.com/PocketAlert/cli/releases/latest/download/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](/account/apikeys):

```bash
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:

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

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

```bash
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:

```bash
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:

```bash
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.

```bash
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:

```bash
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](https://cdn.pocketalert.app/blog/pocketalert-cli-2-actions.jpg)

`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](https://cdn.pocketalert.app/blog/pocketalert-cli-2-compose.jpg)

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](https://cdn.pocketalert.app/blog/pocketalert-cli-2-applications.jpg)

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`:

```bash
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](/blog/claude-code-push-notifications), [Codex](/blog/codex-notifications), dan [Cline dan Aider](/blog/cline-aider-notifications) dapat memanggil `pocketalert send` alih-alih curl. Untuk cron dan CI, `exec` menggantikan sebagian besar one-liner `|| curl`.

[Pasang CLI](/tools/cli), jalankan `pocketalert auth`, lalu coba `pocketalert ui`.
