ReddRadar
Agent skill
debugger
Debugging strategy and constraints for ikigai
Install this agent skill to your Project
npx add-skill https://github.com/mgreenly/ikigai/tree/main/.claude/library/debugger
SKILL.md
Debugger
Debugging strategy for ikigai - a TUI app with special constraints.
Critical Constraint
ikigai requires /dev/tty - it cannot run in subshells or pipes.
Error: Failed to open /dev/tty [src/terminal.c:29]
This means:
./ikigaiin a Bash tool will fail- You cannot capture stdout/stderr directly
- All builds (debug, release, sanitize) have this constraint
Build Modes
| Build | assert() |
Crash behavior |
|---|---|---|
debug (default) |
Active | SIGABRT |
release (-DNDEBUG) |
Compiled out | Segfault/corruption |
sanitize |
Active | SIGABRT + sanitizer report |
Decision Tree
Bug to investigate?
├── Can reproduce in unit test?
│ └── YES → Run test with sanitizers/valgrind
├── Crash on startup?
│ └── Use core dump analysis
├── Runtime crash/hang?
│ └── Use gdbserver
├── Memory issue?
│ └── valgrind or sanitizers on tests
└── Need trace output?
└── Add DEBUG_LOG calls
What NOT To Do
- Don't run
./ikigaidirectly expecting output - Don't pipe ikigai output - it needs a real terminal
- Don't use printf/stderr for debugging (alternate buffer)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mgreenly/ikigai
task-db
mgreenly/ikigai
jj
Jujutsu (jj) skill for the ikigai project
mgreenly/ikigai
github
mgreenly/ikigai
the-ralphs
Overview of the Ralph services and how they fit together in an Ikigai context
mgreenly/ikigai
ralph-goal
Create and manage Ralph goals from Ikigai using the real ralph-pipeline scripts
mgreenly/ikigai
ralph-remembers
Didn't find tool you were looking for?