AgentValley untuk memantau Claude Code di Mac

Apa fungsi AgentValley? Penjelasan sederhana

AgentValley adalah aplikasi Mac gratis dan sumber terbuka yang mengumpulkan sesi Claude Code lokal dalam panel di bawah notch layar. Sederhananya, ini adalah layar pemantauan kecil untuk mengetahui agen mana yang bekerja dan mana yang menunggu jawaban, tanpa membuka setiap jendela terminal. Setiap agen mendapat baris dan karakter piksel sendiri, termasuk subagen yang dijalankan sebuah sesi. Aplikasi memerlukan Claude Code serta macOS 15 atau lebih baru.

Instalasi dan alur penggunaan pertama

1. Unduh DMG resmi, seret AgentValley ke Applications, lalu jalankan. Alternatif Homebrew: brew install --cask morsechimwai/tap/agent-valley.
2. Mulai sesi Claude Code, arahkan penunjuk ke notch, dan cocokkan proyek serta tindakan terakhir.
3. Dari aplikasi lain, tekan Control–Option–Command–A. Pilih baris dengan tombol panah dan tekan Return untuk menuju sesi.
4. Untuk menjawab izin dari panel, aktifkan “Answer from the notch”, jalankan perintah plugin yang ditampilkan di pengaturan, lalu mulai ulang Claude Code. Baca permintaan sebelum memilih “Allow once” atau “Deny”.

Plugin balasan merupakan pemasangan manual terpisah, bukan syarat untuk melihat status biasa.

Temukan agen yang menunggu respons

Sesi dikelompokkan menurut proyek, termasuk worktree proyek tersebut. Kartu sesi memperlihatkan tugas, model, dan langkah terakhir; baris subagen juga menghitung langkah. Ini membantu membedakan pencarian yang didelegasikan dari pekerjaan utama.

Angka merah di dekat notch menandai pertanyaan atau permintaan izin. Buka panel untuk membaca isinya, lalu beralih ke aplikasi terkait. Opsi “Go to the session’s tab” dapat membuka tab yang benar di Terminal dan iTerm2. Di Ghostty, dua sesi dalam folder yang sama bisa membuat pemilihan tab tidak pasti. Suara aktif sejak awal dan dapat dimatikan atau diganti dengan bunyi sederhana.

Memahami estimasi biaya dan batas penggunaan

Tombol grafik membuka History. Pilih hari, minggu, atau bulan, lalu telusuri jam dalam sehari atau sesi proyek. Nilainya dihitung menggunakan harga API, sehingga berguna untuk membandingkan konsumsi tetapi bukan otomatis tagihan langganan Anda. PDF dapat diekspor untuk semua proyek atau satu proyek. Riwayat tetap di Mac setelah Claude Code membersihkan berkas lama.

Panel juga menampilkan token lima jam terakhir dan hari ini, disertai grafik dua belas jam. “Plan limits” mati secara bawaan; setelah diaktifkan, batas lima jam dan mingguan beserta waktu reset akan muncul. Pada pemeriksaan 25 Oktober 2026, aplikasinya gratis dan sponsor bersifat sukarela. Akses Claude Code memiliki ketentuan tersendiri.

Data lokal dan fitur pilihan

Penjelasan publik menyebut pembacaan ~/.claude/projects, ~/.claude/sessions, proses, dan informasi Git proyek. Data aplikasi disimpan di ~/Library/Application Support/AgentValley. Hanya saat “Plan limits” aktif, aplikasi membaca login Claude Code dari Keychain dan mengirimkannya ke api.anthropic.com. Pemeriksaan pembaruan GitHub harian dapat dimatikan.

Baris status terminal pilihan mengubah ~/.claude/settings.json, memasang fon, dan menambah satu baris konfigurasi Ghostty jika diperlukan. Perintah penghapusan membatalkan tambahan ini. Pemakaian data lokal tidak berarti semua konfigurasi bebas koneksi jaringan.

Siapa yang cocok menggunakannya?

Paling bermanfaat bagi pengembang yang menjalankan beberapa sesi lokal dan ingin segera menemukan sesi yang menunggu. Panel dapat dipindahkan ke layar terhubung melalui pengaturan. Status “quiet” berarti tidak ada aktivitas tertulis selama dua menit, bukan bukti macet atau persentase penyelesaian. Cakupan yang didokumentasikan adalah Claude Code di Mac. Kode aplikasi memakai lisensi MIT dan proyek ini tidak berafiliasi dengan Anthropic.

Pertanyaan umum

Apakah AgentValley gratis?

Ya. Aplikasinya gratis dan sumber terbuka. Sponsor opsional tidak menggantikan syarat akses Claude Code.

Apakah estimasi biaya sama dengan tagihan?

Tidak. History memakai harga API untuk memperkirakan biaya. Pembayaran sebenarnya mengikuti paket dan cara penagihan akun Anda.

Apakah perlu plugin untuk melihat sesi?

Tidak untuk pemantauan biasa. Plugin dipasang manual jika Anda ingin mengizinkan atau menolak permintaan langsung dari panel.

Unduhan dan dukungan resmi

• Rilis dan unduhan resmi
• Kode sumber dan panduan pengaturan
• Laporan masalah melalui GitHub Issues