CLI Error Tap

Version: 0.9.0
Updated: 2025-08-26

A precision-first, domain-aware error extractor for terminal commands. Run any command through cli-error-tap and get a crisp root cause with confidence scoring and JSONL events for downstream tooling.

Quick Start

# Local install from this zip (after you download it):
pip install ./cli-error-tap-0.9.0-pkg.zip
# Or unzip and:
pip install .

Run a command:

cli-error-tap -- pip install not-a-real-pkg

See the summary banner on stderr and JSONL written to: ~/.local/share/cli-error-tap/events.jsonl

Features

• High-precision extraction (strict mode defaults to exit!=0 & confident parse)
• Domain parsers: Python, Node.js, Git, Docker, Pip, NPM/Yarn, GCC/Clang, Go/Rust panics, Java/Maven/Gradle, Terraform, systemd
• Generic fallback with debounced selection
• Redaction (tokens, JWT, API keys, emails, IPv4/6, optional path redaction)
• JSONL events with a stable schema (schemas/event.schema.json)
• No external services, local-only by default

Usage

cli-error-tap [--mode {strict,balanced}] [--jsonl PATH] [--no-summary] [--redact-paths] -- <command> [args...]

Examples:

cli-error-tap -- python - <<'PY'
raise FileNotFoundError('data/config.yaml')
PY

cli-error-tap -- node -e "require('not-a-real')"
cli-error-tap -- git push
cli-error-tap -- docker build /no/such/dir
cli-error-tap --mode balanced -- make all

Event Schema

See schemas/event.schema.json for exact fields.

License

MIT