# Cursor push notification: notifikasi saat agent selesai

> Dapatkan push notification di ponsel Anda saat agent Cursor selesai, gagal, atau punya sesuatu untuk disampaikan. Sebuah stop hook untuk setiap run, plus server MCP Pocket Alert untuk pesan yang ditulis sendiri oleh agent.

*12.10.2026*

<!-- source: https://pocketalert.app/id/blog/cursor-push-notifications -->

Agent Cursor bisa me-refactor sebuah modul selagi Anda membuat kopi, tetapi untuk run lokal biasa, Cursor hanya memberi tahu bahwa tugasnya selesai di komputer: lewat suara, atau notifikasi sistem jika Anda mengaktifkannya. Aplikasi iOS Cursor mengirim push saat agent menyelesaikan sebuah giliran, tetapi hanya untuk cloud agent dan sesi yang Anda serahkan lewat Remote Control, dengan paket berbayar dan iPhone; untuk Android masih direncanakan.

Jika Anda ingin push di ponsel saat run agent lokal berakhir, Cursor menyediakan dua cara untuk mengirimkannya:

- **Sebuah hook `stop`.** Cursor menjalankan skrip Anda setiap kali loop agent berakhir, baik selesai, dibatalkan, maupun mengalami error. Andal dan selalu sama.
- **Sebuah tool MCP.** Tambahkan server MCP Pocket Alert dan agent dapat mengirimi Anda push kapan pun Anda memintanya, dengan pesan yang ditulisnya sendiri.

Panduan ini menyiapkan keduanya. Masing-masing memakan waktu beberapa menit.

## Yang Anda butuhkan

- Cursor 1.7 atau lebih baru; hook tersedia sejak 1.7.
- `jq` dan `curl` untuk hook.
- Akun Pocket Alert, kunci API dari [API Keys](/account/apikeys), dan [aplikasi](/get-app) di ponsel Anda. Paket Gratis sudah cukup.

Cursor yang dibuka dari Dock tidak membaca `.zshrc` Anda, sehingga variabel lingkungan yang Anda export di sana tidak terlihat olehnya. Simpan kunci di sebuah file saja:

```bash
mkdir -p ~/.config/pocketalert
printf '%s' 'YOUR_API_KEY' > ~/.config/pocketalert/key
chmod 600 ~/.config/pocketalert/key
```

## Opsi 1. Stop hook untuk setiap run

### Skripnya

Cursor memberikan objek JSON ke hook lewat stdin. Untuk `stop`, objek ini berisi `status` (`completed`, `aborted` atau `error`) dan `workspace_roots`, yaitu folder yang terbuka di jendela. Simpan ini sebagai `~/.cursor/hooks/pocketalert.sh`:

```bash
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspace_roots[0] // "cursor"' <<<"$payload")")
status=$(jq -r '.status // "completed"' <<<"$payload")

case "$status" in
  completed) title="Cursor finished · $project"; level=default ;;
  error)     title="Cursor hit an error · $project"; level=high ;;
  *)         echo '{}'; exit 0 ;;
esac

jq -n --arg t "$title" --arg m "Agent run $status" --arg l "$level" \
  '{title: $t, message: $m, level: $l}' |
  curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
    -H "Token: $(cat ~/.config/pocketalert/key)" \
    -H 'Content-Type: application/json' \
    --data-binary @- >/dev/null 2>&1 || true

echo '{}'
```

```bash
chmod +x ~/.cursor/hooks/pocketalert.sh
```

Run yang dibatalkan sengaja dilewati: jika Anda menekan stop, Anda sudah tahu. Skrip mencetak `{}` karena hook `stop` dapat mengembalikan `followup_message` yang oleh Cursor dikirim kembali ke agent sebagai prompt Anda berikutnya; objek kosong berarti "tidak ada yang perlu ditambahkan".

### Atau dengan Pocket Alert CLI

Dengan [Pocket Alert CLI](/tools/cli) 2.0 atau lebih baru terpasang, blok curl menyusut menjadi satu perintah. CLI sendiri melakukan escape pada teks dan mengambil kunci dari `pocketalert auth`:

```bash
pocketalert send -t "$title" -m "Agent run $status" -l "$level" -q >/dev/null 2>&1 || true
```

Gunakan `-t` dan `-m`, bukan argumen posisional: balasan yang diawali tanda hubung, seperti daftar Markdown, jika tidak akan dibaca sebagai opsi.

### Daftarkan hook-nya

Buat `~/.cursor/hooks.json`:

```json
{
  "version": 1,
  "hooks": {
    "stop": [
      { "command": "/Users/you/.cursor/hooks/pocketalert.sh", "timeout": 10 }
    ]
  }
}
```

Gunakan path absolut ke skrip; ganti `/Users/you` dengan direktori home Anda. File di folder home berlaku untuk setiap proyek. Untuk satu proyek saja, letakkan di `.cursor/hooks.json` dalam repositori.

Cursor memuat ulang `hooks.json` secara otomatis saat file berubah. Berikan agent tugas kecil, dan ponsel Anda akan menampilkan **Cursor finished · your-project** saat tugas itu berakhir.

### Ingin jawaban agent ikut ada di push?

`stop` tidak menyertakan balasan agent, tetapi `afterAgentResponse` menyertakannya sebagai `text`. Untuk mengirim beberapa baris pertama jawaban alih-alih hanya status, daftarkan skrip sejenis pada `afterAgentResponse` dan baca `.text` dari stdin. Hook ini aktif setelah setiap respons, jadi lebih berisik; kebanyakan orang tetap memakai `stop`.

## Opsi 2. Server MCP

Hook memberi tahu Anda bahwa sebuah run telah berakhir. Server MCP memungkinkan agent memberi tahu Anda apa yang terjadi. Tambahkan Pocket Alert ke `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "pocketalert": {
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

Kunci ditulis langsung di file karena masalah Dock di atas. File ini berada di folder home Anda, bukan di dalam repositori. Jika Anda memulai Cursor dari terminal dengan kunci yang sudah di-export, `"Bearer ${env:POCKETALERT_API_KEY}"` juga bisa digunakan.

Buka bagian MCP di Pengaturan Cursor, pastikan `pocketalert` menampilkan tool-nya, lalu tanyakan:

```text
> Run the test suite. When it's done, push me the number of failures with Pocket Alert.
```

Agent memanggil `create_message` dengan ringkasan yang ditulisnya sendiri. Agent juga bisa mengatur `level`, sehingga suite yang gagal dapat tiba sebagai `high`, dan melampirkan tombol aksi pada paket berbayar.

Agar ini menjadi kebiasaan, bukan instruksi per prompt, tambahkan project rule:

```text
When a task takes more than a few minutes, finish by calling the pocketalert
create_message tool with a one-line summary. Use level "high" if anything failed.
```

## Mana yang dipakai

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th></th><th>Stop hook</th><th>Tool MCP</th></tr></thead>
<tbody>
<tr><th>Terpicu</th><td>Setiap run, selalu</td><td>Saat agent memutuskan</td></tr>
<tr><th>Pesan</th><td>Status: completed atau error</td><td>Apa pun yang ditulis agent</td></tr>
<tr><th>Membutuhkan</th><td>Sebuah skrip dan <code>hooks.json</code></td><td>Satu blok di <code>mcp.json</code></td></tr>
<tr><th>Bisa gagal diam-diam</th><td>Hanya jika jaringan mati</td><td>Jika model lupa</td></tr>
</tbody>
</table>
</div>

Menggunakan keduanya sekaligus adalah pilihan default yang baik: hook memastikan Anda mengetahui setiap run, sedangkan tool MCP memberi isi ketika itu penting.

## Persetujuan

Cursor tidak punya hook untuk "agent sedang menunggu persetujuan". `beforeShellExecution` dan `preToolUse` aktif sebelum setiap perintah, termasuk yang dijalankan Cursor tanpa bertanya, sehingga keduanya tidak bisa memberi tahu kapan Anda benar-benar dibutuhkan. Notifikasi desktop Cursor dan aplikasi iOS-nya menangani kasus itu saat ini.

Jika Anda ingin agent berhenti dan meminta izin sebelum langkah berisiko, berikan tool MCP dan aturan untuk mengirim push dengan tombol Approve dan Decline; [Human-in-the-loop notifications](/blog/human-in-the-loop-notifications) menjelaskan cara menjadikannya gerbang yang nyata, bukan sekadar permintaan sopan.

## Jika tidak ada yang masuk

- **Jalankan skripnya secara manual:** `echo '{"status":"completed","workspace_roots":["/tmp/demo"]}' | ~/.cursor/hooks/pocketalert.sh`. Jika tidak ada push yang masuk, hapus `>/dev/null 2>&1` untuk melihat error dari curl.
- **Mulai ulang Cursor** jika hook masih tidak berjalan. Biasanya Cursor memuat ulang `hooks.json` sendiri saat file berubah.
- **Periksa path** di `hooks.json` sudah absolut dan skripnya bisa dieksekusi.
- **Untuk MCP, periksa daftar tool.** Error di samping server pada pengaturan MCP Cursor biasanya berarti kunci salah atau kosong.

## FAQ

### Apakah Cursor sudah punya push notification bawaan?

Di komputer, ya: suara penyelesaian dan notifikasi sistem. Di ponsel, aplikasi iOS Cursor mengirim push saat cloud agent, atau sesi yang Anda serahkan lewat Remote Control, menyelesaikan sebuah giliran. Fitur ini membutuhkan paket berbayar dan iPhone. Run lokal biasa tetap di komputer, dan itulah yang dibahas dalam panduan ini.

### Apakah ini berfungsi untuk background dan cloud agent?

Hook di `~/.cursor/hooks.json` hanya berjalan di mesin Anda, jadi hanya mencakup agent yang berjalan secara lokal. Cloud agent berjalan di server Cursor: mereka menjalankan project hook dari `.cursor/hooks.json` dalam repositori, tetapi tidak menjalankan user hook, dan file kunci tidak tersedia di sana. Untuk itu, rute MCP bisa dipakai jika agent sudah dikonfigurasi dengan server tersebut, atau gunakan aplikasi iOS Cursor atau integrasi Slack-nya.

### Apakah agent melihat kunci API saya?

Pada pengaturan hook, tidak: kunci tetap berada di file yang hanya dibaca oleh skrip. Pada pengaturan MCP, kunci berada di konfigurasi Cursor dan dikirim ke server MCP, bukan ke model.

### Apakah ini gratis?

Ya. Hook dan MCP adalah bagian dari Cursor, dan paket Gratis Pocket Alert mencakup 50 pesan per hari di satu perangkat.

[Dapatkan kunci API](/signup), tambahkan hook-nya, dan biarkan Cursor memberi tahu Anda saat tugasnya selesai.
