Kembali ke Blog

Notifikasi push untuk Cline dan Aider: tahu kapan giliran Anda

Notifikasi push untuk Cline dan Aider: tahu kapan giliran Anda

Cline dan Aider adalah dua agen coding open-source yang paling sering dibiarkan berjalan di latar belakang, dan keduanya bisa menjalankan sebuah perintah ketika ada yang perlu Anda lihat. Tidak satu pun dari keduanya mengirim apa pun ke ponsel Anda dengan sendirinya. Beberapa baris konfigurasi sudah cukup untuk mengubahnya.

  • Cline menjalankan skrip hook ketika sebuah tugas selesai dan berbicara MCP, sehingga ia juga bisa mengirim push yang ia tulis sendiri.
  • Aider menjalankan perintah notifikasi ketika ia menunggu input Anda, setelah sebuah respons atau sebelum konfirmasi ya/tidak.

Keduanya mengirim melalui Pocket Alert, jadi push-nya masuk ke aplikasi yang sama, dengan riwayat yang sama, seperti peringatan dari semua yang lain Anda jalankan.

Yang Anda butuhkan

  • Akun Pocket Alert, kunci API dari Kunci API, dan aplikasi di ponsel iPhone atau Android Anda. Paket gratis sudah cukup.
  • curl, plus jq untuk hook Cline.

Simpan kunci di sebuah file. Editor yang dibuka dari Dock di macOS tidak membaca profil shell Anda, sehingga file adalah satu-satunya tempat yang selalu bisa ditemukan kedua agen:

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

Cline

Hook untuk tugas yang selesai

Hook Cline adalah file yang dapat dieksekusi dan dinamai sesuai event-nya. Letakkan skrip bernama TaskComplete, tanpa ekstensi, di ~/Documents/Cline/Hooks/ dan Cline akan menjalankannya setiap kali sebuah tugas selesai di workspace mana pun. Untuk satu proyek, gunakan .clinerules/hooks/TaskComplete di dalam repositori.

Skrip menerima objek JSON lewat stdin. Untuk TaskComplete, field yang menarik adalah taskComplete.taskMetadata.result, yaitu jawaban akhir Cline, dan workspaceRoots, yaitu folder yang terbuka. Ada juga field initialTask, tetapi ekstensi saat ini mengirimkannya kosong:

#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspaceRoots[0] // "Cline"' <<<"$payload")")
result=$(jq -r '.taskComplete.taskMetadata.result // "" | if . == "" then "Done" else . end' <<<"$payload")

jq -n --arg t "Cline finished · $project" --arg m "${result:0:300}" \
  '{title: $t, message: $m}' |
  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 '{"cancel":false,"contextModification":"","errorMessage":""}'
mkdir -p ~/Documents/Cline/Hooks
# save the script above as ~/Documents/Cline/Hooks/TaskComplete, then:
chmod +x ~/Documents/Cline/Hooks/TaskComplete

Baris terakhir adalah respons hook untuk Cline: jangan membatalkan, jangan menambahkan apa pun ke konteks, tidak ada error. Hook punya batas waktu 30 detik, itulah sebabnya curl dibatasi lima detik.

Pastikan hook aktif: toggle Hooks di pengaturan fitur Cline sudah aktif secara default. Hook berjalan di macOS dan Linux sebagai skrip shell; di Windows, Cline mengharapkan skrip PowerShell bernama TaskComplete.ps1.

Bagaimana dengan "Cline menunggu persetujuan"?

Daftar hook Cline memang menyertakan event Notification untuk keperluan itu, tetapi di ekstensi 4.x saat ini event tersebut sudah didefinisikan namun belum dipanggil. Sampai itu terjadi, belum ada hook yang andal untuk prompt persetujuan: PreToolUse aktif sebelum setiap tool, termasuk yang disetujui otomatis. Jika Anda ingin meninggalkan layar, cara praktisnya adalah memperluas pengaturan persetujuan otomatis Cline untuk tindakan yang aman, lalu biarkan TaskComplete memberi tahu Anda ketika pekerjaan selesai.

Server MCP

Cline adalah klien MCP, jadi ia juga bisa mengirim push melalui server MCP Pocket Alert. Tambahkan ke file pengaturan MCP Cline, ~/.cline/data/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "pocketalert": {
      "type": "streamableHttp",
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" },
      "disabled": false,
      "autoApprove": ["create_message"]
    }
  }
}

Atur type secara eksplisit: tanpa itu, Cline menganggap transport SSE versi lama dan koneksinya gagal. autoApprove membuat Cline bisa mengirim push tanpa bertanya dulu, dan itulah intinya ketika Anda sedang pergi. Versi Cline terbaru membaca file yang sama dari ekstensi VS Code, CLI, dan JetBrains.

Lalu tambahkan instruksi ke .clinerules:

When you finish a task that took more than a few minutes, call the pocketalert
create_message tool with a one-line summary. Use level "high" if something failed.

Aider

Aider sudah memiliki notifikasi bawaan. Dengan --notifications, ia menampilkan notifikasi desktop (atau membunyikan bel terminal) ketika menunggu input, dan --notifications-command menggantinya dengan perintah apa pun yang Anda inginkan. Hanya itu yang dibutuhkan untuk push ke ponsel.

Perintahnya

Aider menjalankan perintah lewat shell tanpa argumen, jadi skrip menyusun pesan dari apa yang bisa ia lihat: direktori saat ini adalah repositori tempat Aider bekerja.

#!/usr/bin/env bash
project=$(basename "$PWD")

curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
  -H "Token: $(cat ~/.config/pocketalert/key)" \
  -H 'Content-Type: application/json' \
  -d "{\"title\": \"Aider is waiting · $project\", \"message\": \"Your turn: reply or confirm in the terminal.\"}" \
  >/dev/null 2>&1 || true

Simpan sebagai ~/.config/pocketalert/aider-notify.sh lalu jalankan chmod +x.

Dengan CLI Pocket Alert 2.0 atau yang lebih baru terpasang dan sudah diautentikasi, Anda bisa melewati skrip dan memasukkan perintah langsung ke konfigurasi di bawah:

notifications-command: 'pocketalert send -t "Aider is waiting · $(basename "$PWD")" -m "Your turn, reply or confirm in the terminal" -q'

Tanda kutip tunggal mencegah YAML membaca sisa baris; Aider menyerahkannya ke shell apa adanya.

Aktifkan

Tambahkan dua baris ke ~/.aider.conf.yml, atau ke .aider.conf.yml di dalam repositori:

notifications: true
notifications-command: ~/.config/pocketalert/aider-notify.sh

Atau untuk satu kali jalan:

aider --notifications --notifications-command ~/.config/pocketalert/aider-notify.sh

Kapan notifikasinya muncul

Aider mengirim satu notifikasi per respons dari model, pada momen pertama ia menunggu Anda setelahnya. Biasanya itu adalah prompt normal setelah ia selesai mengedit. Jika hal pertama yang ia butuhkan adalah konfirmasi, seperti "Add file to the chat?" atau "Run shell command?", push akan datang untuk konfirmasi itu, yaitu kasus "menunggu persetujuan". Konfirmasi lanjutan dalam pertukaran yang sama tidak mengirim push lagi.

Aider tidak mendukung MCP, jadi perintah notifikasi adalah jalan yang tepat. Itu juga sudah cukup: Aider menunggu Anda setelah setiap respons, dan di saat itulah Anda ingin tahu.

Apa yang masuk ke ponsel Anda

AgenJudulIsi
ClineCline finished · api300 karakter pertama hasil Cline
Cline via MCPApa pun yang ditulis agenRingkasan yang ia pilih untuk dikirim
AiderAider is waiting · apiYour turn: reply or confirm in the terminal.

Pesan default menggunakan prioritas normal. Tambahkan "level": "high" ke JSON jika Anda ingin pesan tetap lolos dari Fokus di iPhone, atau buat tetap senyap dengan "low" dan periksa riwayatnya saat Anda kembali.

Jika tidak ada yang masuk

  • Jalankan skrip secara manual. Untuk Cline, echo '{}' | ~/Documents/Cline/Hooks/TaskComplete; untuk Aider, ~/.config/pocketalert/aider-notify.sh. Jika tidak ada push, periksa kunci atau jaringan; hapus >/dev/null 2>&1 untuk melihat respons curl.
  • Periksa nama file. Cline mencocokkan hook berdasarkan nama file: harus persis TaskComplete, dapat dieksekusi, tanpa .sh.
  • Periksa kunci konfigurasi Aider. Gunakan notifications-command dengan tanda hubung, seperti di contoh konfigurasi Aider.

FAQ

Apakah saya perlu kedua agen?

Tidak. Kedua bagian ini berdiri sendiri; atur saja yang Anda gunakan.

Apakah Cline atau Aider bisa melihat kunci API saya?

Hook dan perintah notifikasi membaca kunci dari sebuah file dan tidak menjadi bagian dari percakapan. Konfigurasi MCP menyimpan kunci agar Cline bisa terhubung ke server; kunci itu tidak dikirim ke model.

Apakah Aider akan membanjiri saya saat saya sedang bekerja di depan layar?

Ia mengirim satu push per respons. Jika itu terlalu banyak saat Anda sedang di meja, jalankan Aider tanpa --notifications dan gunakan file konfigurasi hanya untuk sesi panjang, atau tambahkan pemeriksaan di awal skrip, seperti [ -f ~/.aider-away ] || exit 0, lalu buat file tersebut saat Anda meninggalkan meja.

Apakah ini gratis?

Ya. Cline dan Aider bersifat open source, dan paket gratis Pocket Alert mencakup 50 pesan per hari untuk satu perangkat.

Dapatkan kunci API, pasang skripnya, dan biarkan agen menghubungi Anda kembali.

Bagikan artikel ini