ReddRadar
Agent skill
gdbserver
GDB Server skill for the ikigai project
Install this agent skill to your Project
npx add-skill https://github.com/mgreenly/ikigai/tree/main/.claude/library/gdbserver
SKILL.md
GDB Server
Description
Remote debugging with gdbserver for TUI apps that use alternate screen buffer.
Why gdbserver
This app uses the alternate terminal buffer. Running GDB directly would conflict with the TUI. gdbserver separates the debugger from the application's terminal.
Workflow
Terminal 1 - Start app under gdbserver:
gdbserver :1234 ./ikigai
Terminal 2 - Connect with GDB:
gdb ./ikigai -ex "target remote :1234"
Key Commands
bt # Backtrace
frame N # Select stack frame
info locals # Local variables
print var # Inspect variable
list # Source at current location
break file:line # Set breakpoint
continue # Resume execution
step / next # Step into / over
When Crashes Occur
gdbserver keeps the crashed process frozen. Connect and inspect:
gdb ./ikigai -ex "target remote :1234"
(gdb) bt # See crash location
(gdb) info registers
(gdb) print *ptr # Inspect state at crash
Limitations
- TUI output not visible (process attached to gdbserver)
- Very early crashes may need coredump analysis instead
- Inspect internal state via variables, not screen output
References
- GDB manual: https://sourceware.org/gdb/current/onlinedocs/gdb/
- See
coredump.mdfor early crash debugging
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?