DEV Community

Cover image for I built a Python CLI that tells you exactly what's wrong with your dev environment
Axiolev
Axiolev

Posted on

I built a Python CLI that tells you exactly what's wrong with your dev environment

#python #devtools #cli #debugging

Every developer has a story.

Mine was 3 hours debugging a port conflict. The fix was one line.

That's when I built root.

What it does

Run root in any project directory when something breaks:

$ root

PROBLEM=Missing DATABASE_URL
ROOT_CAUSE=.env not loaded
FIX=Add DATABASE_URL to .env
CONFIDENCE=HIGH (96%)
TIME_TO_FIX=~10 seconds
TIME_SAVED=~25 minutes
AUTO_FIX_AVAILABLE=true
Enter fullscreen mode Exit fullscreen mode

Not logs. Not suggestions. A root cause engine.

State → diagnosis → fix. Zero guessing.

Install 

curl -s https://root-jade-kappa.vercel.app/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

Free. No account. No password. 10 seconds.

Try the demo 

root --demo
Enter fullscreen mode Exit fullscreen mode

Works even if your system is healthy — shows you what a real diagnosis looks like.

Current detection patterns

  • Missing .env file
  • Missing DATABASE_URL
  • Port 3000 conflict
  • Node.js version mismatch
  • Missing node_modules
  • Python venv not set up

What's next

More detection patterns. Looking for feedback — what failures do you hit most often?

GitHub: https://github.com/mkaxiolev-max/root
Site: https://zeroguess.dev

Top comments (0)