Bun Debug

What it does

The Bun Debug skill enables AI agents to launch scripts with Bun's debugger enabled, facilitating interactive debugging of Bun code. It provides commands for starting the debugger, breaking at the first line of execution, waiting for a debugger attachment, and specifying custom ports. The skill then reports a debug URL and offers guidance on connecting using a browser or VSCode.

When to use it

• When you need to step through your Bun code to understand its behavior.
• To quickly identify the source of errors in small scripts by breaking at the first line.
• For debugging tests within your Bun project.
• When integrating with a debugger like VSCode and needing assistance setting up the launch configuration.

Key capabilities

• Launches scripts with Bun's debugger enabled.
• Supports breaking at the first line of execution (--inspect-brk).
• Allows waiting for debugger attachment (--wait).
• Enables specifying a custom port for debugging (--port).
• Provides instructions on connecting to the debug URL via browser or VSCode.
• Suggests VSCode launch configuration settings.

Example prompts

• "Debug my script my_script.bun."
• "Run test *.js with the debugger and break at the first line."
• "Start debugging main.bun on port 8080."

Tips & gotchas

• The skill requires a Bun installation to be available in the environment.
• After launching, follow the provided instructions to connect your browser or VSCode debugger to the reported WebSocket URL.
• Familiarize yourself with standard debugging controls like F8 (continue), F10 (step over), and F11 (step into).