debug-assistant

debug

Debug Assistant — Analyze error messages, stack traces, and logs. Get instant diagnosis and fix suggestions for common programming errors.

Commands

| Command | Description | Example | |---------|-------------|---------| | analyze | Parse and diagnose an error message or stack trace | analyze "TypeError: Cannot read property 'foo' of undefined" | | explain | Explain what an error code or exception type means | explain ECONNREFUSED | | suggest | Suggest fixes for a given error pattern | suggest "ModuleNotFoundError: No module named 'requests'" |

Usage

bash script.sh analyze "your error message or stack trace here"
bash script.sh explain ENOENT
bash script.sh suggest "SyntaxError: Unexpected token }"

You can also pipe input:

cat error.log | bash script.sh analyze -

Features

Requirements

Examples

$ bash script.sh analyze "ECONNREFUSED 127.0.0.1:5432"
🔍 Error Analysis
─────────────────────────────────────
Type     : System / Network Error
Code     : ECONNREFUSED
Severity : HIGH
Summary  : Connection actively refused by the target host
Root Cause:
  The service at 127.0.0.1:5432 is not running or is not
  accepting connections on that port.
Fix Suggestions:
  1. Check if the service is running:
       sudo systemctl status postgresql
  2. Verify the port is correct and the service is bound to it:
       ss -tlnp | grep 5432
  3. Check firewall rules:
       sudo ufw status
  4. Confirm connection string in your config/env

$ bash script.sh explain ModuleNotFoundError
📖 Error Explanation
─────────────────────────────────────
Name     : ModuleNotFoundError
Language : Python
Category : ImportError subclass
Description:
  Raised when Python cannot locate the specified module.
  This is a subclass of ImportError introduced in Python 3.6.
Common Causes:
  • Package not installed in the current environment
  • Virtual environment not activated
  • Typo in the module name
  • Module installed for a different Python version

$ bash script.sh analyze "ECONNREFUSED 127.0.0.1:5432"
🔍 Error Analysis
─────────────────────────────────────
Type     : System / Network Error
Code     : ECONNREFUSED
Severity : HIGH
Summary  : Connection actively refused by the target host
Root Cause:
  The service at 127.0.0.1:5432 is not running or is not
  accepting connections on that port.
Fix Suggestions:
  1. Check if the service is running:
       sudo systemctl status postgresql
  2. Verify the port is correct and the service is bound to it:
       ss -tlnp | grep 5432
  3. Check firewall rules:
       sudo ufw status
  4. Confirm connection string in your config/env

$ bash script.sh explain ModuleNotFoundError
📖 Error Explanation
─────────────────────────────────────
Name     : ModuleNotFoundError
Language : Python
Category : ImportError subclass
Description:
  Raised when Python cannot locate the specified module.
  This is a subclass of ImportError introduced in Python 3.6.
Common Causes:
  • Package not installed in the current environment
  • Virtual environment not activated
  • Typo in the module name
  • Module installed for a different Python version