evolinkai-debug-assistant 1.0.0

package/README.md

@@ -0,0 +1,18 @@
+# Debug Assistant — npm installer
+
+This package installs the Debug Assistant skill for OpenClaw / Claude Code.
+
+## Install
+
+```
+npx evolinkai-debug-assistant
+```
+
+## What it does
+
+Copies the Debug Assistant skill files into your project's `skills/` directory.
+
+## Links
+
+- [ClawHub](https://clawhub.ai/evolinkai/debug-assistant)
+- [GitHub](https://github.com/EvoLinkAI/debug-skill-for-openclaw)

package/bin/install.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const SLUG = "debug-assistant";
+const VERSION = "1.0.0";
+const SKILL_FILES_DIR = path.join(__dirname, "..", "skill-files");
+
+function findWorkdir() {
+  const envDir = process.env.CLAWHUB_WORKDIR?.trim() || process.env.CLAWDHUB_WORKDIR?.trim();
+  if (envDir) return path.resolve(envDir);
+
+  let dir = process.cwd();
+  while (true) {
+    if (fs.existsSync(path.join(dir, ".clawhub")) || fs.existsSync(path.join(dir, ".clawdhub"))) {
+      return dir;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return process.cwd();
+}
+
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) copyDirSync(srcPath, destPath);
+    else fs.copyFileSync(srcPath, destPath);
+  }
+}
+
+function updateLockfile(workdir) {
+  const lockDir = path.join(workdir, ".clawhub");
+  const lockFile = path.join(lockDir, "lock.json");
+  fs.mkdirSync(lockDir, { recursive: true });
+
+  let lock = { skills: {} };
+  if (fs.existsSync(lockFile)) {
+    try { lock = JSON.parse(fs.readFileSync(lockFile, "utf8")); if (!lock.skills) lock.skills = {}; }
+    catch { lock = { skills: {} }; }
+  }
+
+  lock.skills[SLUG] = { version: VERSION, installedAt: Date.now() };
+  fs.writeFileSync(lockFile, JSON.stringify(lock, null, 2) + "\n");
+}
+
+function writeOrigin(targetDir) {
+  fs.writeFileSync(path.join(targetDir, ".clawhub-origin.json"),
+    JSON.stringify({ version: 1, registry: "https://api.clawhub.ai", slug: SLUG, installedVersion: VERSION, installedAt: Date.now() }, null, 2) + "\n");
+}
+
+function main() {
+  console.log(`\n  Debug Assistant — OpenClaw Skill Installer v${VERSION}`);
+  console.log(`  Powered by evolink.ai\n`);
+
+  const workdir = findWorkdir();
+  const targetDir = path.join(workdir, "skills", SLUG);
+
+  if (fs.existsSync(targetDir)) {
+    console.log(`  Already installed at: ${targetDir}`);
+    console.log(`  Use "npx clawhub update ${SLUG}" to update.\n`);
+    process.exit(0);
+  }
+
+  console.log(`  Installing to: ${targetDir}`);
+  copyDirSync(SKILL_FILES_DIR, targetDir);
+  writeOrigin(targetDir);
+  updateLockfile(workdir);
+  console.log(`  Installed ${SLUG}@${VERSION}\n`);
+
+  console.log("  Next steps:");
+  console.log("  1. export EVOLINK_API_KEY=\"your-key-here\"");
+  console.log("     Get a free key: https://evolink.ai/signup");
+  console.log("  2. bash scripts/debug.sh analyze error.log");
+  console.log("  3. bash scripts/debug.sh help");
+  console.log("");
+}
+
+main();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "evolinkai-debug-assistant",
+  "version": "1.0.0",
+  "description": "AI-powered debugging assistant. Analyze error logs, explain errors, parse stack traces, get fix suggestions. OpenClaw skill installer. Powered by evolink.ai",
+  "bin": {
+    "evolinkai-debug-assistant": "bin/install.js"
+  },
+  "files": [
+    "bin/",
+    "skill-files/"
+  ],
+  "keywords": [
+    "openclaw",
+    "clawhub",
+    "debug",
+    "debugging",
+    "error",
+    "stacktrace",
+    "ai",
+    "claude",
+    "evolink",
+    "skill"
+  ],
+  "author": "EvoLinkAI <support@evolink.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EvoLinkAI/debug-skill-for-openclaw"
+  },
+  "homepage": "https://clawhub.ai/evolinkai/debug-assistant"
+}

package/skill-files/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: Debug Assistant
+description: AI-powered debugging assistant. Analyze error logs, explain error messages, parse stack traces, and get fix suggestions with cheatsheets for 8 languages. Powered by evolink.ai
+version: 1.0.0
+homepage: https://github.com/EvoLinkAI/debug-skill-for-openclaw
+metadata: {"openclaw":{"homepage":"https://github.com/EvoLinkAI/debug-skill-for-openclaw","requires":{"bins":["python3","curl"],"env":["EVOLINK_API_KEY"]},"primaryEnv":"EVOLINK_API_KEY"}}
+---
+
+# 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](https://evolink.ai?utm_source=clawhub&utm_medium=skill&utm_campaign=debug)
+
+## When to Use
+
+- User shares an error log and asks "what went wrong?"
+- User pastes an error message and wants an explanation
+- User has a stack trace and needs help understanding it
+- User has buggy code and a known error, wants fix suggestions
+- User needs quick debugging commands for a specific language
+
+## Quick Start
+
+### 1. Set your EvoLink API key
+
+    export EVOLINK_API_KEY="your-key-here"
+
+Get a free key: [evolink.ai/signup](https://evolink.ai/signup?utm_source=clawhub&utm_medium=skill&utm_campaign=debug)
+
+### 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 <file>` | Analyze error log — summary, root cause, error chain, fix steps |
+| `explain <error_message>` | Explain error — meaning, common causes, quick fix, proper fix |
+| `trace <file>` | Parse stack trace — origin, call chain, root cause, fix |
+| `suggest <file> --error <msg>` | 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](https://evolink.ai/signup?utm_source=clawhub&utm_medium=skill&utm_campaign=debug) |
+| `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**
+
+- `api.evolink.ai` — AI error analysis (AI commands only)
+
+**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
+
+- [GitHub](https://github.com/EvoLinkAI/debug-skill-for-openclaw)
+- [EvoLink API](https://docs.evolink.ai/en/api-manual/language-series/claude/claude-messages-api?utm_source=clawhub&utm_medium=skill&utm_campaign=debug)
+- [Community](https://discord.com/invite/5mGHfA24kn)
+- [Support](mailto:support@evolink.ai)

package/skill-files/_meta.json

@@ -0,0 +1,18 @@
+{
+  "name": "Debug Assistant",
+  "version": "1.0.0",
+  "description": "AI-powered debugging assistant. Analyze error logs, explain error messages, parse stack traces, and get fix suggestions. Includes cheatsheets for 8 languages. Powered by evolink.ai",
+  "author": "EvoLinkAI",
+  "license": "MIT",
+  "type": "tool",
+  "requiredFiles": [],
+  "requiredEnvVars": ["EVOLINK_API_KEY"],
+  "optionalEnvVars": ["EVOLINK_MODEL"],
+  "requiredBinaries": ["python3", "curl"],
+  "externalServices": [
+    "api.evolink.ai"
+  ],
+  "dataTransmission": {
+    "api.evolink.ai": "AI commands (analyze, explain, trace, suggest) send user-provided error logs, messages, or code to api.evolink.ai for analysis by Claude. No data is stored after the response is returned. Info commands (languages, cheatsheet) run locally and never transmit data."
+  }
+}

package/skill-files/scripts/debug.sh

@@ -0,0 +1,460 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Debug Assistant — AI-powered debugging for error logs, stack traces, and code
+# Usage: bash debug.sh <command> [options]
+#
+# Commands:
+#   languages                          — List supported languages
+#   cheatsheet [language]              — Quick debugging commands
+#   analyze <file>                     — AI analyze error log file
+#   explain <error_message>            — AI explain an error message
+#   trace <file>                       — AI parse and explain stack trace
+#   suggest <file> --error <message>   — AI suggest fixes for code with error
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+EVOLINK_API="https://api.evolink.ai/v1/messages"
+
+# --- Helpers ---
+err() { echo "Error: $*" >&2; exit 1; }
+
+to_native_path() {
+  if [[ "$1" =~ ^/([a-zA-Z])/ ]]; then
+    echo "${BASH_REMATCH[1]}:/${1:3}"
+  else
+    echo "$1"
+  fi
+}
+
+check_deps() {
+  command -v python3 &>/dev/null || err "python3 not found."
+  command -v curl &>/dev/null || err "curl not found."
+}
+
+read_file() {
+  local file="$1"
+  [ -f "$file" ] || err "File not found: $file"
+  cat "$file"
+}
+
+evolink_ai() {
+  local prompt="$1"
+  local content="$2"
+
+  local api_key="${EVOLINK_API_KEY:?Set EVOLINK_API_KEY for AI features. Get one at https://evolink.ai/signup}"
+  local model="${EVOLINK_MODEL:-claude-opus-4-6}"
+
+  local tmp_prompt tmp_content tmp_payload
+  tmp_prompt=$(mktemp)
+  tmp_content=$(mktemp)
+  tmp_payload=$(mktemp)
+  trap "rm -f '$tmp_prompt' '$tmp_content' '$tmp_payload'" EXIT
+
+  printf '%s' "$prompt" > "$tmp_prompt"
+  printf '%s' "$content" > "$tmp_content"
+
+  local native_prompt native_content native_payload
+  native_prompt=$(to_native_path "$tmp_prompt")
+  native_content=$(to_native_path "$tmp_content")
+  native_payload=$(to_native_path "$tmp_payload")
+
+  python3 -c "
+import json, sys
+
+with open(sys.argv[1], 'r', encoding='utf-8') as f:
+    prompt = f.read()
+with open(sys.argv[2], 'r', encoding='utf-8') as f:
+    content = f.read()
+
+data = {
+    'model': sys.argv[4],
+    'max_tokens': 4096,
+    'messages': [
+        {
+            'role': 'user',
+            'content': prompt + '\n\n' + content
+        }
+    ]
+}
+with open(sys.argv[3], 'w', encoding='utf-8') as f:
+    json.dump(data, f)
+" "$native_prompt" "$native_content" "$native_payload" "$model"
+
+  local response
+  response=$(curl -s -X POST "$EVOLINK_API" \
+    -H "Authorization: Bearer $api_key" \
+    -H "Content-Type: application/json" \
+    -d "@$tmp_payload")
+
+  echo "$response" | python3 -c "
+import json, sys
+data = json.load(sys.stdin)
+if 'content' in data:
+    for block in data['content']:
+        if block.get('type') == 'text':
+            print(block['text'])
+elif 'error' in data:
+    print(f\"AI Error: {data['error'].get('message', str(data['error']))}\", file=sys.stderr)
+else:
+    print(json.dumps(data, indent=2))
+"
+}
+
+# --- Cheatsheets ---
+
+cheatsheet_js() {
+  cat <<'EOF'
+JavaScript / TypeScript Debugging:
+
+  # Node.js debugger
+  node --inspect-brk app.js
+  # Then open chrome://inspect
+
+  # Console debugging
+  console.log(JSON.stringify(obj, null, 2))
+  console.trace('Call stack here')
+  console.time('perf'); /* code */ console.timeEnd('perf')
+
+  # Memory leaks
+  node --expose-gc --max-old-space-size=4096 app.js
+
+  # Common errors:
+  Cannot read property of undefined  → Add optional chaining (?.) or validate data
+  Module not found                   → npm install, check tsconfig paths
+  Hydration mismatch (React)         → Ensure consistent SSR/CSR, use useEffect
+EOF
+}
+
+cheatsheet_python() {
+  cat <<'EOF'
+Python Debugging:
+
+  # Built-in debugger
+  python -m pdb script.py
+
+  # Breakpoint in code (Python 3.7+)
+  breakpoint()
+
+  # Memory tracing
+  python -X tracemalloc script.py
+
+  # Profiling
+  python -m cProfile -s cumulative script.py
+
+  # Common errors:
+  IndexError: list index out of range  → Check list length before access
+  KeyError                             → Use dict.get(key, default)
+  ImportError / ModuleNotFoundError    → pip install, check sys.path
+  TypeError: NoneType                  → Function returning None unexpectedly
+EOF
+}
+
+cheatsheet_go() {
+  cat <<'EOF'
+Go Debugging:
+
+  # Delve debugger
+  dlv debug main.go
+  (dlv) break main.main
+  (dlv) continue
+  (dlv) print myVar
+  (dlv) goroutines
+
+  # Race condition detection
+  go run -race main.go
+  go test -race ./...
+
+  # Profiling
+  go test -cpuprofile cpu.prof -memprofile mem.prof -bench .
+  go tool pprof cpu.prof
+
+  # Common errors:
+  nil pointer dereference       → Check nil before accessing struct fields
+  deadlock                      → Review goroutine/channel usage, use -race
+  cannot use X as type Y        → Check interface implementation
+EOF
+}
+
+cheatsheet_rust() {
+  cat <<'EOF'
+Rust Debugging:
+
+  # GDB / LLDB
+  rust-gdb target/debug/myapp
+  rust-lldb target/debug/myapp
+
+  # Verbose compiler output
+  RUST_BACKTRACE=1 cargo run
+  RUST_BACKTRACE=full cargo run
+
+  # Logging
+  RUST_LOG=debug cargo run   # requires env_logger
+
+  # Common errors:
+  borrow checker errors         → Review ownership, use clone() or Rc/Arc
+  cannot move out of borrowed   → Use references or .clone()
+  thread 'main' panicked        → Check unwrap() calls, use match/if let
+EOF
+}
+
+cheatsheet_java() {
+  cat <<'EOF'
+Java Debugging:
+
+  # Remote debugging
+  java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar app.jar
+
+  # Heap dump
+  jmap -dump:format=b,file=heap.hprof <pid>
+
+  # Thread dump
+  jstack <pid>
+
+  # GC logging
+  java -Xlog:gc*:file=gc.log -jar app.jar
+
+  # Common errors:
+  NullPointerException          → Null check or use Optional
+  ClassNotFoundException        → Check classpath, dependency versions
+  OutOfMemoryError              → Increase -Xmx, check for leaks
+  ConcurrentModificationException → Use Iterator.remove() or CopyOnWriteArrayList
+EOF
+}
+
+cheatsheet_network() {
+  cat <<'EOF'
+Network Debugging:
+
+  # HTTP debugging
+  curl -v https://api.example.com/endpoint
+  curl -w "time_total: %{time_total}s\n" -o /dev/null -s https://example.com
+
+  # DNS
+  dig example.com
+  nslookup example.com
+
+  # Ports
+  lsof -i :3000
+  netstat -tlnp
+
+  # TCP connections
+  ss -tunapl
+
+  # Common errors:
+  ECONNREFUSED        → Service not running on expected port
+  CORS error          → Backend missing CORS headers
+  ETIMEDOUT           → Firewall, DNS, or service unreachable
+  SSL certificate     → Check cert expiry, chain, hostname match
+EOF
+}
+
+cheatsheet_css() {
+  cat <<'EOF'
+CSS / Layout Debugging:
+
+  /* Outline all elements */
+  * { outline: 1px solid red !important; }
+
+  /* Debug specific element */
+  .debug { background: rgba(255,0,0,0.1) !important; }
+
+  /* Show overflow */
+  * { overflow: visible !important; }
+
+  Common issues:
+  Element not visible       → Check display, visibility, opacity, z-index
+  Unexpected overflow       → Find element wider than viewport with outline trick
+  Flexbox not working       → Check parent display:flex, child flex properties
+  Grid misalignment         → Use Firefox Grid Inspector
+EOF
+}
+
+cheatsheet_git() {
+  cat <<'EOF'
+Git Bisect (binary search for bugs):
+
+  git bisect start
+  git bisect bad                # Current commit is broken
+  git bisect good abc1234       # Known good commit
+  # Git checks out middle commit — test it, then:
+  git bisect good   # or   git bisect bad
+  # Repeat until root cause commit is found
+  git bisect reset
+
+  # Automated bisect with test script
+  git bisect start HEAD abc1234
+  git bisect run npm test
+EOF
+}
+
+# --- Commands ---
+
+cmd_languages() {
+  echo "Supported Languages & Tools:"
+  echo ""
+  echo "  javascript    JS/TS — Node.js debugger, console, memory"
+  echo "  python        pdb, breakpoint, tracemalloc, cProfile"
+  echo "  go            Delve, race detection, pprof"
+  echo "  rust          GDB/LLDB, RUST_BACKTRACE, env_logger"
+  echo "  java          Remote debug, jmap, jstack, GC logging"
+  echo "  network       curl, dig, lsof, netstat, ss"
+  echo "  css           Outline tricks, layout debugging"
+  echo "  git           git bisect for binary search debugging"
+}
+
+cmd_cheatsheet() {
+  local lang="${1:-all}"
+  case "$lang" in
+    javascript|js|typescript|ts) cheatsheet_js ;;
+    python|py)                   cheatsheet_python ;;
+    go|golang)                   cheatsheet_go ;;
+    rust|rs)                     cheatsheet_rust ;;
+    java|jvm)                    cheatsheet_java ;;
+    network|net)                 cheatsheet_network ;;
+    css|layout)                  cheatsheet_css ;;
+    git|bisect)                  cheatsheet_git ;;
+    all)
+      cheatsheet_js; echo ""; echo "---"; echo ""
+      cheatsheet_python; echo ""; echo "---"; echo ""
+      cheatsheet_go; echo ""; echo "---"; echo ""
+      cheatsheet_rust; echo ""; echo "---"; echo ""
+      cheatsheet_java; echo ""; echo "---"; echo ""
+      cheatsheet_network; echo ""; echo "---"; echo ""
+      cheatsheet_css; echo ""; echo "---"; echo ""
+      cheatsheet_git ;;
+    *) err "Unknown language: $lang. Run 'debug.sh languages' for the list." ;;
+  esac
+}
+
+cmd_analyze() {
+  local file="${1:?Usage: debug.sh analyze <error-log-file>}"
+  check_deps
+
+  echo "Reading log file..." >&2
+  local content
+  content=$(read_file "$file")
+  local truncated
+  truncated=$(echo "$content" | head -c 12000)
+
+  echo "Analyzing errors..." >&2
+  evolink_ai "You are a senior debugging engineer. Analyze this error log and provide:
+
+1. **Error Summary** — What went wrong, in one sentence.
+2. **Root Cause** — The most likely underlying cause.
+3. **Error Chain** — If multiple errors exist, show the causal chain (which error triggered which).
+4. **Affected Components** — Which parts of the system are involved.
+5. **Fix Steps** — Numbered, actionable steps to resolve the issue.
+6. **Prevention** — How to prevent this from happening again.
+
+Be specific. Reference exact error messages, line numbers, and file paths from the log. Do not give generic advice." "ERROR LOG:
+$truncated"
+}
+
+cmd_explain() {
+  local message="$*"
+  [ -z "$message" ] && err "Usage: debug.sh explain <error_message>"
+  check_deps
+
+  echo "Analyzing error..." >&2
+  evolink_ai "You are a senior debugging engineer. Explain this error message:
+
+1. **What it means** — Plain English explanation.
+2. **Common causes** — Top 3 most likely causes, ranked by probability.
+3. **Quick fix** — The fastest way to resolve it.
+4. **Proper fix** — The correct long-term solution.
+5. **Related errors** — Other errors that often appear alongside this one.
+
+Be concise and practical. No filler." "ERROR MESSAGE:
+$message"
+}
+
+cmd_trace() {
+  local file="${1:?Usage: debug.sh trace <stacktrace-file>}"
+  check_deps
+
+  echo "Reading stack trace..." >&2
+  local content
+  content=$(read_file "$file")
+  local truncated
+  truncated=$(echo "$content" | head -c 12000)
+
+  echo "Parsing stack trace..." >&2
+  evolink_ai "You are a senior debugging engineer. Parse and explain this stack trace:
+
+1. **Exception/Error** — The top-level error type and message.
+2. **Origin** — The exact file, line, and function where the error originated.
+3. **Call Chain** — Simplified call chain from entry point to error (skip framework internals, focus on user code).
+4. **Root Cause** — What most likely went wrong at the origin point.
+5. **Fix** — Specific code change to resolve this.
+
+Format the call chain as a clean, readable list. Highlight user code vs framework/library code." "STACK TRACE:
+$truncated"
+}
+
+cmd_suggest() {
+  local file=""
+  local error_msg=""
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --error) shift; error_msg="$*"; break ;;
+      -*) err "Unknown option: $1" ;;
+      *) file="$1"; shift ;;
+    esac
+  done
+
+  [ -z "$file" ] && err "Usage: debug.sh suggest <code-file> --error <error_message>"
+  [ -z "$error_msg" ] && err "Missing --error. Provide the error message."
+  check_deps
+
+  echo "Reading code..." >&2
+  local content
+  content=$(read_file "$file")
+  local truncated
+  truncated=$(echo "$content" | head -c 12000)
+
+  echo "Generating fix suggestions..." >&2
+  evolink_ai "You are a senior debugging engineer. The user has this code file that produces the error shown below.
+
+1. **Bug Location** — Identify the exact line(s) causing the error.
+2. **Why It Fails** — Explain the root cause.
+3. **Fix** — Show the corrected code (minimal diff, only change what's needed).
+4. **Verification** — How to verify the fix works.
+
+Show the fix as a before/after code diff. Do not rewrite the entire file — only show the relevant section." "ERROR: $error_msg
+
+CODE FILE ($file):
+$truncated"
+}
+
+# --- Main ---
+COMMAND="${1:-help}"
+shift || true
+
+case "$COMMAND" in
+  languages)    cmd_languages ;;
+  cheatsheet)   cmd_cheatsheet "$@" ;;
+  analyze)      cmd_analyze "$@" ;;
+  explain)      cmd_explain "$@" ;;
+  trace)        cmd_trace "$@" ;;
+  suggest)      cmd_suggest "$@" ;;
+  help|*)
+    echo "Debug Assistant — AI-powered debugging from your terminal"
+    echo ""
+    echo "Usage: bash debug.sh <command> [options]"
+    echo ""
+    echo "Info Commands (no API key needed):"
+    echo "  languages                          List supported languages"
+    echo "  cheatsheet [language]              Debugging commands cheatsheet"
+    echo ""
+    echo "AI Commands (requires EVOLINK_API_KEY):"
+    echo "  analyze <file>                     Analyze error log file"
+    echo "  explain <error_message>            Explain an error message"
+    echo "  trace <file>                       Parse and explain stack trace"
+    echo "  suggest <file> --error <message>   Suggest fixes for code"
+    echo ""
+    echo "Languages: javascript, python, go, rust, java, network, css, git"
+    echo ""
+    echo "Get a free EvoLink API key: https://evolink.ai/signup"
+    ;;
+esac