git-truck

Git Truck - visualize your repo

Git Truck allows you to get an understanding of how your repository is structured, where there has been the most activity at different points in time, and who worked on which parts of the code base.

Local analysis of the .git folder

🔒 GitTruck analyses the history of your project based on your local .git folder. It runs completely locally, so your code stays on your machine, and it is never uploaded to the cloud, as is the case with many similar tools.

How does it work?

For each file in your repository, Git Truck allows you to map metrics onto it:

You can mix and match these metrics to answer different questions about your project. The following examples show a few questions that Git Truck can answer for your team:

👨‍💻 Are we overreliant on one developer?

supabase

Example from Supabase – an open source Firebase alternative.

💻 Where in the system have we been working recently?

pocketbase

Example from Pocketbase – another alternative to Firebase.

🗓️ How has our focus shifted over time?

By selecting different time intervals on which the analysis is performed, in the Zeeguu frontend project, one can see various stages of the project:

  1. At first, most activity was focused on the “teacher”-folder, with Sara being the top author.

web2

  1. Later, focus shifted to the “exercises”-folder, with no activity in the “teacher”-folder, and Mircea is now the top author.

web1

⚠️ Do some files have extreme levels of activity, indicating poor separation of concerns?

pandas

Example from Pandas

🛠️ Who is responsible for different subsystems?

topauth

📂 What is the folder structure of a complex project?

linux

Example from Linux

How to get started

The only requirements are

To run git truck, navigate to a repository or a folder containing multiple repositories in your terminal, and run npx git-truck