Debugger
SkillMonitoring & opsSession problem log for improving ppstack. The debugger extension logs failed bash, read, and subagent calls on its own; the model calls the log_problem tool when it was wrong, was corrected, dropped a path, or hit leftover work. /debugger prints the log. Use when something breaks or surprises you, when corrected, or when the user says debugger.
Available today. Use it from your connected AI after setup.
No other account needed.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the Debugger skill
What this skill tells your AI
The instructions your AI receives, as published by peterpme/dotfiles in skills/ppstack/skills/debugger/SKILL.md and read by ahel’s review.
One TSV beside the Pi session file, <session>.problems.tsv, with columns ts, kind, problem, fix, status, target, trace. Never in a repo. Never committed.
Two writers.
- The extension (
pi/extensions/debugger) appends a row for every failedbash,read, orsubagentcall, skipping lookups that fail by design (rg,grep,fd,find,ls,git diff) and repeating an identical failure once per session. No model tokens. - The model appends the rows only it can see with one
log_problemcall:kindiswrong-assumption,correction,wrong-path,leftover, ordrift;problemis one line;fixis one line or omitted while open;targetis the ppstack skill, playbook, script, or Pi config file that should change so it does not recur. One call, keep working. Do not discuss the row unless it blocks the work.
Skip routine progress and guesses that were right. Do not grep the tree for TODOs to fill the log. Only the parent logs; a child names its snag in its report.
/debugger prints the log with no model turn. scripts/log.sh <file> <kind> <problem> <fix> <status> <target> [trace] writes a row by hand with the same columns.
Nothing here is promoted anywhere. The human reads the log and decides what changes. reflect is separate and mines the transcript on its own.
Signals
- GitHub stars
- 93
- Forks
- 13
- Last commit
- Sep 2026
- Hacker News mentions
- 20
Advanced
- Item type
- skill
- Key
debugger-peterpme- Source
- github.com/peterpme/dotfiles