kernel-debug-loop

What problem does it solve?

Traditional kernel debugging often involves long boot times and manual log analysis, slowing down development. This Skill provides a rapid feedback loop by running the Breenix kernel in short, time-bounded sessions, automatically detecting specific log signals and terminating quickly. This dramatically accelerates iterative debugging and verification.

Core Features & Use Cases

• Signal-Based Termination: Automatically stops the kernel when a predefined log message (signal) is detected.
• Time-Bounded Execution: Limits kernel runtime to a specified timeout, preventing endless hangs.
• Real-time Output Monitoring: Streams kernel logs directly to your console, providing immediate visibility.
• Use Case: You're developing a new interrupt handler and need to quickly verify it initializes correctly. Use this Skill with a signal like "Interrupt handler initialized" and a 10-second timeout. The kernel will run, print its logs, and stop as soon as the signal appears (or timeout), giving you instant feedback on your changes.

Quick Start

Run kernel, stop when "KERNEL_INITIALIZED" appears (max 15s)

kernel-debug-loop/scripts/quick_debug.py --signal "KERNEL_INITIALIZED"

Run kernel for 30 seconds without specific signal

kernel-debug-loop/scripts/quick_debug.py --timeout 30

Run in BIOS mode, watching for "Boot complete"

kernel-debug-loop/scripts/quick_debug.py --signal "Boot complete" --mode bios