AX
Artifex.
GitHub
โ† All tools
๐Ÿ”Debugging

RootCause

AI diagnoses any failing test. Exact root cause. One-keystroke fix.

Point RootCause at any failing pytest, jest, or mocha test. It watches the execution, reads the source, scans git history, and returns a precise root cause with a unified diff you can apply instantly.

View on GitHub โ†—
$pip install rootcause
rootcause โ€” zsh
โ†’ rootcause pytest tests/test_auth.py::test_login
โ–ฎ

/ the problem

You get a stack trace. You still have to figure out why.

Every failing test hands you a stack trace and leaves you to do the detective work. You copy-paste into ChatGPT, it guesses. You grep through files, you check git log. 15 minutes later you find a one-line fix. RootCause collapses that to one command.

/ how it works

Four steps. One command.

1
โ–ถ

Run the test

Executes pytest, jest, or mocha and captures full stdout, stderr, exit code

2
โŸณ

Instrument execution

sys.settrace captures the exact call order, local variables, and line numbers for every frame

3
โ—ˆ

Gather context

Reads ยฑ30 lines of source around the failure and the last 5 git commits touching those files

4
โœฆ

Claude diagnoses

Returns root cause, exact location, confidence score, and a unified diff fix

/ use cases

When to reach for RootCause

โœ“Flaky CI tests you can't reproduce locally
โœ“Auth failures on timezone-sensitive systems
โœ“Race conditions in async code
โœ“Database constraint errors in test fixtures

Ready to use RootCause?

MIT licensed. One command install. Works in CI today.

$pip install rootcause
Full docs on GitHub โ†—

/ stay in the loop

New tools ship weekly.

Get notified when new tools land, features ship, or a tool reaches 1k stars. No noise. Unsubscribe any time.