bugsight-0.9.0 is not a library.

bugsight

Debug smarter, not harder.

A fast Rust CLI that analyzes errors, stack traces and logs — and tells you exactly how to fix them.

bugsight demo

Install

cargo install bugsight

Usage

# Pipe any command output
cargo build 2>&1 | bugsight

# Explain an error directly
bugsight --explain 'permission denied'

# Analyze a log file
bugsight --file logs/error.log

# Show error history
bugsight --history

# Show error statistics
bugsight --stats

# Machine-readable JSON output
bugsight --explain 'NullPointerException' --json

# Create config file
bugsight --init

Supported languages

Language	Errors covered
Rust	panics, compile errors, unwrap errors
Go	nil pointer, index out of range, missing modules
Python	ModuleNotFoundError, TypeError, KeyError, IndentationError
Node.js	Cannot find module, undefined property, EADDRINUSE
Docker	daemon not running, permission denied, port conflicts
Git	merge conflicts, push rejected, SSH errors
Java	NullPointerException, OutOfMemoryError, StackOverflow
PHP	syntax errors, memory limit, undefined variables
Ruby	NoMethodError, LoadError, Rails RecordNotFound
C/C++	segfault, memory leaks, linker errors, buffer overflow
General	permission denied, file not found

AI fallback

For unknown errors, bugsight uses Groq (free):

export GROQ_API_KEY=gsk_xxxxxx

Without the key, bugsight still works with its built-in parsers.

Config

bugsight --init

Creates ~/.bugsight.toml:

# Enable AI fallback
ai_enabled = true

# Save analyzed errors to history
history_enabled = true

# Language: "en" or "fr"
language = "en"

# Max errors in history
max_history = 100

JSON output

bugsight --explain 'permission denied' --json

{
  "error_type": "Permission Error",
  "message": "permission denied",
  "suggestion": "Try running with sudo or check file permissions with ls -la."
}

Stats

bugsight --stats

Error Statistics
────────────────────────────────────────
Type                           Count
────────────────────────────────────────
Permission Error               3  75% ███
Runtime Panic                  1  25% █
────────────────────────────────────────
Total errors analyzed: 4

Contributing

Contributions are welcome! The easiest way is to add a new parser.

Fork the repo
Create a branch: git checkout -b feat/your-parser
Add src/parsers/your_lang.rs
Register it in src/parsers/mod.rs
Add tests
Run cargo test
Open a Pull Request

See CONTRIBUTING.md for details.

bugsight 0.9.0