Debug Assistant

Debug Assistant

AI-powered debugging from your terminal. Analyze error logs, explain error messages, parse stack traces, get fix suggestions, and access debugging cheatsheets for 8 languages.

Powered by Evolink.ai

When to Use

Quick Start

1. Set your EvoLink API key

export EVOLINK_API_KEY="your-key-here"

Get a free key: evolink.ai/signup

2. Analyze an error

bash scripts/debug.sh analyze error.log

bash scripts/debug.sh explain "Cannot read property 'map' of undefined"

3. Get a cheatsheet

bash scripts/debug.sh cheatsheet python

Capabilities

AI Commands (require EVOLINK_API_KEY)

| Command | Description | |---------|-------------| | analyze | Analyze error log — summary, root cause, error chain, fix steps | | explain | Explain error — meaning, common causes, quick fix, proper fix | | trace | Parse stack trace — origin, call chain, root cause, fix | | suggest --error | Fix suggestions — bug location, why it fails, corrected code |

Info Commands (no API key needed)

| Command | Description | |---------|-------------| | languages | List all supported languages | | cheatsheet [language] | Debugging commands and common errors |

Supported Languages

| Language | Debugger | Key Tools | |----------|----------|-----------| | javascript | Node --inspect, Chrome DevTools | console.trace, memory profiling | | python | pdb, breakpoint() | tracemalloc, cProfile | | go | Delve | -race flag, pprof | | rust | rust-gdb, rust-lldb | RUST_BACKTRACE, env_logger | | java | Remote JDWP | jmap, jstack, GC logging | | network | curl -v, dig | lsof, netstat, ss | | css | Outline trick | Grid/Flex inspectors | | git | git bisect | Automated bisect with test scripts |

Examples

Analyze an error log

bash scripts/debug.sh analyze server-crash.log

Output:

Error Summary: Node.js process crashed due to unhandled promise rejection in the database connection pool.

Root Cause: The PostgreSQL connection string contains an expired SSL certificate path, causing all new connections to fail silently...

Fix Steps: 1. Update the SSL certificate at /etc/ssl/certs/db.pem 2. ...

Explain an error message

bash scripts/debug.sh explain "ECONNREFUSED 127.0.0.1:5432"

Parse a stack trace

bash scripts/debug.sh trace crash-dump.txt

Suggest fixes for buggy code

bash scripts/debug.sh suggest api/handler.py --error "KeyError: 'user_id'"

Configuration

| Variable | Default | Required | Description | |---|---|---|---| | EVOLINK_API_KEY | — | Yes | Your EvoLink API key. Get one free | | EVOLINK_MODEL | claude-opus-4-6 | No | Model for AI analysis |

Required binaries: python3, curl

Security

Data Transmission

AI commands send user-provided content (error logs, messages, code files) to api.evolink.ai for analysis by Claude. By setting EVOLINK_API_KEY and using these commands, you consent to this transmission. Data is not stored after the response is returned. The languages and cheatsheet commands run entirely locally and never transmit data.

Network Access

Persistence & Privilege

This skill creates temporary files for API payload construction which are cleaned up automatically. No credentials or persistent data are stored. The skill only reads files explicitly passed as arguments — it never scans or reads files on its own.

Links

Analyze an error log

bash scripts/debug.sh analyze server-crash.log

Output:

Error Summary: Node.js process crashed due to unhandled promise rejection in the database connection pool.

Root Cause: The PostgreSQL connection string contains an expired SSL certificate path, causing all new connections to fail silently...

Fix Steps: 1. Update the SSL certificate at /etc/ssl/certs/db.pem 2. ...

Explain an error message

bash scripts/debug.sh explain "ECONNREFUSED 127.0.0.1:5432"

Parse a stack trace

bash scripts/debug.sh trace crash-dump.txt

Suggest fixes for buggy code

bash scripts/debug.sh suggest api/handler.py --error "KeyError: 'user_id'"

| Variable | Default | Required | Description | |---|---|---|---| | EVOLINK_API_KEY | — | Yes | Your EvoLink API key. Get one free | | EVOLINK_MODEL | claude-opus-4-6 | No | Model for AI analysis |

Required binaries: python3, curl