Claude Bug Catcher

If you've ever spent time trying to debug a stubborn bug on Linux, you know that time is sometimes of the essence.

If you are trying to pinpoint the cause of a hard-to-resolve bug, having it in very recent history makes navigating through lengthy and verbose system logs much easier.

The objective of this simple wrapper/utility is to leverage the power of artificial intelligence to help in this process.

The idea for Bug Catcher is to provide a utility that streamlines capturing bugs in the moment quickly such that it can be launched with a single hotkey, capture on-the-spot user remarks like "the freeze is happening now!" and pass that to Claude for analysis - all in a few seconds.

Method of Operation

It presents a dialog window with quick-select presets for common issues, then provides that to Claude with a system prompt asking it to check the logs and move towards remediation. The objective is that this can be launched as a simple GUI or as a CLI, enabling quick and effective remediation of bugs.

Quick-Select Presets

When launched, you get a menu with one-click options:

Preset	Description
GPU/Graphics freeze	GPU freeze or glitch happening now
System freeze	System unresponsive
Audio issue	Crackling, dropout, device issues
Network issue	Connection dropped or unstable
App crashed	Application just crashed
Memory/slowdown	System slow, possible OOM
USB device issue	Device not recognized
That bug again!	Reference to recurring issue
Custom...	Free-form description

The goal: hotkey → one click → Claude is analyzing logs

How It Works

1. Assign the script to a hotkey (e.g., Super+B for "bug")
2. When a bug occurs, hit the hotkey
3. Click the relevant preset (or type custom description)
4. Claude launches and immediately starts checking logs

Installation

# Clone the repo
git clone https://github.com/danielrosehill/Claude-Bug-Catcher.git
cd Claude-Bug-Catcher

# Make executable
chmod +x bug-catcher.sh

# Install desktop entry (optional)
cp claude-bug-catcher.desktop ~/.local/share/applications/
update-desktop-database ~/.local/share/applications/

Setting Up a Hotkey (KDE Plasma)

1. Open System Settings → Shortcuts → Custom Shortcuts
2. Edit → New → Global Shortcut → Command/URL
3. Set trigger to your preferred key (e.g., Super+B)
4. Set action to: /path/to/bug-catcher.sh

Requirements

• Claude CLI (claude command available)
• KDE Plasma (uses kdialog and konsole)
• For other desktop environments, modify the script to use zenity/gnome-terminal

Usage

Run directly:

./bug-catcher.sh

Or via hotkey, or find "Claude Bug Catcher" in your application menu.

Author

Daniel Rosehill https://danielrosehill.com

---

For more Claude Code projects, visit my Claude Code Repos Index.