Troubleshooting

Die meisten Probleme liegen an lokalen git hooks, fehlenden git notes oder GitHub Pages Einstellungen.

Schnelle Checks

Lokales Setup prüfen.
Terminal-Fenster
```
npx agent-note status
```
Note für den Commit prüfen.
Terminal-Fenster
```
npx agent-note show
```

Remote notes prüfen.

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

Vom Symptom starten

Symptom	Startpunkt
PR Report ist leer	Prüfen Sie, ob Notes gepusht wurden und der Workflow die vollständige Git-Historie holt
Ein erwarteter Prompt fehlt	Vergleichen Sie `compact` und `full`
Dashboard öffnet, aber die PR hat keine Daten	Prüfen Sie, ob die Notes dieser PR veröffentlicht wurden
`git commit` erstellt keine Note	Führen Sie `init` erneut aus und prüfen Sie die `git:` Zeile in `status`
Line Estimate fehlt	Prüfen Sie, ob der Agent genug Bearbeitungsbelege liefern kann

PR Report ist leer

Der PR-Branch wurde nach Aktivierung von Agent Note gepusht.
refs/notes/agentnote existiert auf dem Remote.
actions/checkout nutzt fetch-depth: 0.
Die PR enthält Commits mit Dateien, die vom Agent bearbeitet wurden.

Agent Note schreibt keine Note für Commits, in denen keine committete Datei dem Agent zugeordnet werden kann.

Wenn der Header Total AI Ratio: — und Agent Note data: No tracked commits zeigt, enthält die PR zwar Commits, aber für diese Commits wurden keine Agent-Note-Daten gefunden. Das ist nicht dasselbe wie eine echte AI Ratio von 0%.

Prompts fehlen

Prompt selection folgt dem commit-to-commit Fenster, nicht dem gesamten Chat.

compact hält den Bericht fokussiert und zeigt die Prompts, die den Commit erklären.
full zeigt alle gespeicherten Prompts.
Alte Task-Prompts werden entfernt, wenn der aktuelle Commit eine eigene Erklärung hat.
📝 Context erscheint bei kurzen Prompts, wenn Dateinamen oder Code-Bezeichner sie erklären.

with:
  prompt_detail: full

Dashboard zeigt keine Daten

GitHub Pages Source muss GitHub Actions sein.
Der Workflow muss dashboard: true verwenden.
Der erste erfolgreiche Deploy erstellt /dashboard/.
Wenn Pull Request Deploys blockiert sind, erscheinen Open PR Daten nach dem Merge.

Dashboard öffnet die falsche PR

Die Dashboard-Startseite sollte die gemeinsame Historie anzeigen und nicht automatisch zu ?pr= wechseln. Nur PR-Report-Links setzen das passende ?pr=<number>.

Wenn ein alter Pages-Deploy noch weiterleitet, starten Sie den Dashboard-Workflow erneut oder warten Sie auf den nächsten erfolgreichen Deploy von main.

`git commit` wird nicht getrackt

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

Git hooks liegen lokal in .git/; jeder Clone braucht ein eigenes init.

Line Estimate fehlt

Das ist oft normal:

Claude Code liefert meist genug Belege für Line Estimate.
Codex CLI kann Zeilen nur schätzen, wenn die Patch-Zählung aus dem Transcript zum finalen Diff passt.
Cursor kann Zeilen nur schätzen, wenn die Edit-Zählung passt und die finale Datei noch zur letzten KI-Änderung passt.
Gemini CLI zeigt aktuell nur AI Ratio auf Datei-Ebene.

Wenn Belege unvollständig sind, fällt Agent Note auf eine sichere Bewertung zurück, statt zu raten.