[ShowDev] I built a Git terminal dashboard in Python (my first proper project!) and would love some feedback 🚀

Hey DEV community! 👋

I’m currently learning Python and building my skills as a developer. Because I don't know many other developers in real life to ask for advice, I’m hoping to borrow a few minutes of your time!

I recently finished building my first "proper" project, and I would love to get some fresh eyes on the code.

🛠 What I Built
It's called giteyes. It is a Python-based terminal dashboard that lets you explore a repository's git commit activity, view heatmaps, and track file churn hotspots directly from the command line.

You can check out the repository here:
👉 https://github.com/henderson-01/giteyes

💡 Why I Built It
I wanted a way to quickly visualise Git history without leaving the terminal or opening up a web browser, and I figured building a CLI (Command Line Interface) tool would be the perfect way to push my Python skills further.

🔍 What I’m Looking For
Since this is my first major project, I know there is a lot I don't know yet. I would be incredibly grateful for any feedback, but I'm specifically curious about:

Code Structure: Are my Python files logically organised?

Best Practices: Are there any glaring anti-patterns or non-Pythonic ways I'm doing things?

Error Handling: How does it behave if you feed it a weird repository?

General Readability: Is the code easy to follow?

Please feel free to be completely honest; I'm here to learn and improve, still a bit nervous though. You can drop a comment below or open an issue on GitHub if you spot something specific.

Thank you so much in advance to anyone who takes the time to look! Happy coding!