Troubleshooting

Sebagian besar masalah berasal dari local git hooks, git notes yang belum tersedia, atau pengaturan GitHub Pages.

Pemeriksaan cepat

Periksa local setup.
Terminal window
```
npx agent-note status
```
Periksa apakah commit punya note.
Terminal window
```
npx agent-note show
```

Periksa remote notes.

git fetch origin refs/notes/agentnote:refs/notes/agentnote
git notes --ref=agentnote show HEAD

Mulai dari gejalanya

Gejala	Mulai dari sini
PR Report kosong	Pastikan notes sudah di-push dan workflow mengambil git history lengkap
Prompt yang diharapkan tidak muncul	Bandingkan `compact` dan `full`
Dashboard terbuka, tetapi PR tidak punya data	Periksa apakah notes untuk PR itu sudah dipublikasikan
`git commit` tidak membuat note	Jalankan `init` lagi dan lihat baris `git:` di `status`
Line Estimate tidak muncul	Periksa apakah agent dapat menyediakan bukti edit yang cukup

PR Report kosong

PR branch di-push setelah Agent Note diaktifkan.
refs/notes/agentnote ada di remote.
actions/checkout memakai fetch-depth: 0.
PR berisi commit dengan file yang disentuh agent.

Agent Note tidak menulis note untuk commit ketika tidak ada committed file yang dapat dikaitkan dengan agent.

Jika header menampilkan Total AI Ratio: — dan Agent Note data: No tracked commits, PR memiliki commit tetapi Agent Note data untuk commit tersebut tidak ditemukan. Itu berbeda dari AI Ratio 0% yang sebenarnya.

Prompt hilang

Prompt selection mengikuti commit-to-commit window, bukan seluruh session.

compact menjaga laporan tetap fokus dengan menampilkan prompt yang menjelaskan commit.
full menampilkan semua prompt yang disimpan.
Prompt task lama dilewati jika commit saat ini sudah punya penjelasan sendiri.
📝 Context muncul untuk prompt pendek ketika nama file atau code identifier membantu menjelaskannya.

with:
  prompt_detail: full

Dashboard tidak punya data

GitHub Pages source harus GitHub Actions.
Workflow harus menjalankan dashboard: true.
Deploy sukses pertama membuat /dashboard/.
Jika Pull Request Deploys diblokir, Open PR data muncul setelah merge.

Dashboard membuka PR yang salah

Halaman awal Dashboard seharusnya menampilkan riwayat bersama tanpa memaksa pindah ke ?pr=. Hanya link dari PR Report yang menambahkan ?pr=<number> untuk PR saat ini.

Jika deploy Pages lama masih melakukan redirect, jalankan ulang workflow Dashboard atau tunggu deploy berikutnya dari main berhasil.

`git commit` tidak terlacak

npx agent-note status
npx agent-note init --agent claude

Git hooks bersifat local di .git/, jadi setiap clone perlu init.

Line Estimate tidak muncul

Ini sering normal. Claude Code biasanya menyediakan bukti edit yang cukup untuk Line Estimate. Codex CLI hanya dapat memperkirakan baris ketika jumlah patch transcript cocok dengan final commit diff. Cursor hanya dapat melakukannya ketika jumlah edit cocok dan final file masih cocok dengan edit AI terakhir. Gemini CLI saat ini hanya menampilkan AI Ratio di level file.

Jika bukti tidak lengkap, Agent Note kembali ke penilaian aman alih-alih menebak.