agent-tracker — plugin Claude Code

Plugin Claude Code internal Star Perkasa. Plugin ini mencatat waktu aktivitas Claude Code (session, chat, tool, dan lama agent bekerja) lalu mengirimnya ke API agent-tracker. Isi prompt, isi file, dan input tool tidak pernah dibaca maupun dikirim. Yang dikirim hanya metadata: jenis event, waktu, nama project (nama folder), nama tool, dan email akun Claude.

Pasang

Butuh Node.js 18+ dan Claude Code. Jalankan sekali di setiap laptop:

npm install -g @starasia/agent-tracker
agent-tracker setup

Lalu restart Claude Code. Tidak perlu konfigurasi lain, dan tidak perlu akses ke repo GitHub: file plugin ikut di dalam paket npm, lalu setup menyalinnya ke sebuah folder, mendaftarkannya sebagai marketplace lokal starasia, dan memasang agent-tracker@starasia.

Saat pertama kali dijalankan, setup menanyakan lokasi folder plugin (bawaan ~/.agent-tracker). Bisa juga langsung ditentukan:

agent-tracker setup --dir ~/tools/agent-tracker   # folder pilihan sendiri
agent-tracker setup -y                            # tanpa pertanyaan, pakai ~/.agent-tracker

Tanpa install global juga bisa: npx @starasia/agent-tracker setup.

Perintah

| Perintah | Fungsi | |---|---| | agent-tracker setup [--dir <folder>] [-y] | Pasang plugin, atau perbarui ke versi paket yang terpasang (folder tetap) | | agent-tracker move <folder> | Pindahkan folder plugin ke lokasi lain; folder lama dibersihkan | | agent-tracker status | Cek plugin aktif, lokasi folder, event yang belum terkirim, dan koneksi API | | agent-tracker uninstall | Hapus plugin beserta foldernya |

Folder plugin jangan dihapus atau dipindah manual, karena Claude Code membaca plugin dari sana. Pakai agent-tracker move.

Update

npm install -g @starasia/agent-tracker@latest
agent-tracker setup

Lalu restart Claude Code.

Cara lain tanpa npm

Bagi yang punya akses read ke repo ini:

claude plugin marketplace add Star-Perkasa-Technology/agent-tracker-installation
claude plugin install agent-tracker@starasia

Kalau laptop dikelola lewat MDM, atau akun Claude-nya akun organisasi, admin bisa menyebar isi managed-settings.json, baik lewat MDM maupun lewat claude.ai → Organization settings → Claude Code → Managed settings.

Cek plugin berjalan

Jalankan agent-tracker status. Event yang gagal terkirim (misalnya saat offline) disimpan di ~/.claude/agent-tracking/queue.jsonl dan dikirim ulang otomatis.

Rilis versi baru (admin)

1. Ubah file di plugins/agent-tracker/.
2. Samakan version di package.json, plugins/agent-tracker/.claude-plugin/plugin.json, dan .claude-plugin/marketplace.json.
3. Jalankan claude plugin validate ., commit dan push ke main, lalu npm publish.

Alamat API dan token ingest ada di plugins/agent-tracker/config.sh. Token ini hanya bisa mengirim event, tidak bisa membaca laporan.