Metadata-Version: 2.4
Name: errex
Version: 0.1.0
Summary: Paste or pipe any error message and get a plain-English explanation powered by Claude
Author: Bsel153
License: MIT
Project-URL: Repository, https://github.com/Bsel153/errex
Keywords: debugging,errors,ai,claude,developer-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Debuggers
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: anthropic

# errex — Error Explainer

Paste or pipe any error message and get a clear, plain-English explanation powered by Claude.

```
$ cat traceback.txt | errex.py

────────────────────────────────────────────────────
  errex — Error Analysis
────────────────────────────────────────────────────

**TypeError: unsupported operand type(s) for +: 'int' and 'str'**

This is a Python type error...
```

## Install

```bash
pip install git+https://github.com/Bsel153/errex.git
export ANTHROPIC_API_KEY=sk-...
```

Requires Python 3.8+ and an [Anthropic API key](https://console.anthropic.com/).

## Usage

```bash
# Interactive — paste your error, then Ctrl+D (Mac/Linux) or Ctrl+Z+Enter (Windows)
errex

# Read from a file
errex traceback.txt

# Pipe from another command
cat error.log | errex
errex < error.log

# One-paragraph summary instead of full analysis
errex --brief traceback.txt

# Hint the language when the error is ambiguous
errex --lang rust traceback.txt

# Copy the explanation to the clipboard
errex --copy traceback.txt

# Structured JSON output (error_type, root_cause, fix_steps, gotchas)
errex --json traceback.txt

# Use a different Claude model
errex --model claude-opus-4-7 traceback.txt
```

Past explanations are saved to `~/.errex_history` (one JSON object per line).

## What you get

For any error, errex explains:

1. **What kind of error it is** and which language or tool produced it
2. **What it means** in plain English
3. **The most likely root cause**, ranked by probability
4. **Numbered fix steps** with code snippets where helpful
5. **Common gotchas** — the non-obvious things that trip people up
