Debug

Error tracing, log analysis, memory leak detection, HTTP debugging, and command profiling — all from the command line. Analyze log files for error patterns, parse stack traces from Python/Java/Go/JS crash dumps, monitor process memory for leaks, benchmark command execution, compare log files side-by-side, and debug HTTP endpoints with timing and SSL inspection.

Commands

trace — Find error patterns in log files

Scans a log file for error-level patterns (ERROR, FATAL, Exception, Traceback, WARN, OOM, Segfault, panic, SIGKILL, SIGSEGV). Shows match count, error breakdown by type, last 20 matching lines, and top 10 unique error patterns (with timestamps and addresses normalized for dedup).

bash scripts/script.sh trace /var/log/app.log
bash scripts/script.sh trace --pattern "OOM\|Segfault\|FATAL" /var/log/syslog
bash scripts/script.sh trace --last 1h /var/log/app.log
bash scripts/script.sh trace --last 2d --pattern "Exception" application.log

Options:

• --pattern REGEX — Custom grep pattern (default: common error keywords)
• --last 1h|30m|2d — Filter to entries within the last N hours/minutes/days

Output: Error breakdown table, last 20 matches, unique pattern summary. Exit code 1 if errors found, 0 if clean.

stacktrace — Parse and summarize stack traces

Auto-detects language (Python, Java, JavaScript, Go, C/C++), extracts the error message, and shows the call chain with file/line references. Accepts a file path or stdin (-).

bash scripts/script.sh stacktrace crash.log
cat traceback.txt | bash scripts/script.sh stacktrace -

Supported languages: Python (Traceback), Java (at ...java:N), JavaScript/TypeScript (at ...js:N), Go (goroutine), C/C++ (thread #N).

Output: Language detection, error message, call chain (with file + line), stack depth.

leaks — Monitor process memory for leaks

Samples a running process's RSS and VSZ at regular intervals, then calculates total growth. Flags possible leaks (>20% growth) or moderate growth (>5%).

bash scripts/script.sh leaks --pid 1234
bash scripts/script.sh leaks --pid 1234 --duration 60 --interval 5
bash scripts/script.sh leaks 5678

Options:

• --pid PID — Process ID to monitor (required)
• --duration N — Total monitoring time in seconds (default: 30)
• --interval N — Sampling interval in seconds (default: 5)

Output: Time-series table (RSS, VSZ, delta), summary with start/end RSS and growth percentage.

profile — Measure command execution time

Runs a command one or more times, measures wall-clock time per run (nanosecond precision), and reports min/avg/max with a speed verdict.

bash scripts/script.sh profile "python3 slow_script.py"
bash scripts/script.sh profile --repeat 5 "curl -s https://api.example.com"
bash scripts/script.sh profile --repeat 10 "make build"

Options:

• --repeat N — Number of runs (default: 1)