errxplain 0.1.0

Pipe any error → get an instant AI explanation. Just type 'why'.

errxplain 🔍

Pipe any error. Get an instant, human explanation.

npm run build 2>&1 | errxplain

No more googling cryptic stack traces. errxplain reads your error and tells you exactly what went wrong, why, and how to fix it — in plain English.

Demo

Installation

pip install errxplain

Usage

Works with any language or tool:

# Python
python app.py 2>&1 | errxplain

# Node / npm
npm run build 2>&1 | errxplain

# Rust
cargo build 2>&1 | errxplain

# Any command
<your-command> 2>&1 | errxplain

Show the original error alongside the explanation:

python app.py 2>&1 | errxplain --verbose

Setup

pip install errxplain
export GROQ_API_KEY=your_key_here  # Free at console.groq.com

Add the export to your ~/.zshrc or ~/.bashrc to make it permanent.

How it works

errxplain reads from stdin, sends the error to an LLM (via Groq — fast and free), and formats the response into a clean, readable breakdown.

Contributing

PRs welcome! Open an issue first to discuss major changes.

License

MIT