bun-debug
Bun debugger via --inspect. Use when the user wants to debug a TS/JS file interactively, break at first line, wait for attach, or debug tests with --inspect-brk.
How do I install this agent skill?
npx skills add https://github.com/laurigates/claude-plugins --skill bun-debugIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides instructions for using Bun's built-in debugger to troubleshoot TypeScript and JavaScript files. It uses standard Bun inspector commands to host a local debugging session on localhost.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
/bun:debug
Launch a script with Bun's debugger enabled for interactive debugging.
When to Use This Skill
| Use this skill when... | Use typescript-debugging instead when... |
|---|---|
Attaching an interactive debugger to a Bun script via --inspect | Diagnosing TypeScript compile errors or type mismatches |
Breaking at the first line of a fast-exiting script (--inspect-brk) | Setting up VSCode launch configurations for non-Bun runtimes |
Debugging Bun tests with bun --inspect-brk test | Use bun-test when you just want to run tests, not step through them |
| Waiting for a debugger to attach before execution | Use bun-build when reproducing a build-time error |
Parameters
file(required): Script file to debug--brk: Break at first line (for fast-exiting scripts)--wait: Wait for debugger to attach before running--port=<port>: Use specific port (default: auto-assigned)
Execution
Standard debug (opens debug URL):
bun --inspect $FILE
Break at first line:
bun --inspect-brk $FILE
Wait for debugger attachment:
bun --inspect-wait $FILE
Custom port:
bun --inspect=$PORT $FILE
Debug tests:
bun --inspect-brk test $PATTERN
Output
The command outputs a debug URL:
------------------- Bun Inspector -------------------
Listening: ws://localhost:6499/
Open: debug.bun.sh/#localhost:6499
-----------------------------------------------------
Post-launch
- Report the debug URL to user
- Explain how to connect:
- Open
debug.bun.sh/#localhost:<port>in browser - Or use VSCode with Bun extension attached to the WebSocket URL
- Open
- Remind about breakpoint controls (F8 continue, F10 step over, F11 step into)
VSCode Integration
For VSCode debugging, suggest adding to .vscode/launch.json:
{
"type": "bun",
"request": "launch",
"name": "Debug",
"program": "${file}",
"stopOnEntry": true
}
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/laurigates/claude-plugins/bun-debug">View bun-debug on skillZs</a>