dabit3

dabit3 / git-chronicle

Public

Index your git history into a searchable database with analytics and insights. CLI for contributor stats, file hotspots, and code velocity.

14
2
100% credibility
Found Feb 10, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A tool that scans code project histories to let users search past changes, view contributor stats, identify active files, and generate project health reports.

How It Works

1
🔍 Discover the Tool

You find a helpful companion for exploring the story behind your code project's changes over time.

2
💻 Add It to Your Setup

You easily bring the tool onto your computer so it's ready to use anytime.

3
📁 Open Your Project Folder

You navigate to the folder holding your code project that you want to understand better.

4
📚 Study the History

You ask the tool to review all the past updates in your project, and it gathers everything neatly with a progress show.

5
🔎 Search for Moments

You look up specific changes, people involved, or time periods to find exactly what you're curious about.

6
📊 Uncover Insights

You check out stats on top contributors, busiest files, and activity patterns that reveal your project's heartbeat.

🎉 Project Story Revealed

Now you have clear reports and understanding of your code's journey, making onboarding, reviews, and planning a breeze.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is git-chronicle?

git-chronicle is a Python CLI tool that indexes any git repository into a local SQLite database, turning raw commit history into searchable analytics. Run `git-chronicle index` on your repo to capture commits, authors, and file changes, then query with `search "fix bug" --author alice` or generate stats like `stats hotspots` for most-edited files and `stats velocity` for code churn metrics. It handles git index basics without the usual git index file corrupt or lock headaches, delivering contributor rankings, timelines, and project reports in text, JSON, or HTML.

Why is it gaining traction?

Unlike raw `git log` or web tools like GitHub's built-in analytics, it provides local, instant full-text search across commits and files, plus CLI-driven insights like weekly activity bars and top contributor tables with pretty terminal output. The hook is zero-setup indexing of any git repo—local, GitHub, GitLab—with exports for dashboards, making git index meaning actionable for daily dev workflows. Developers grab it for quick onboarding reports without uploading code.

Who should use this?

Team leads auditing contributor patterns or file hotspots in legacy codebases. New hires ramping up on who owns what via `stats contributors`. Maintainers spotting code velocity dips in monorepos. Solo devs generating project health summaries for stakeholders.

Verdict

At 12 stars and 1.0% credibility, this beta CLI shows solid docs and Python packaging but lacks tests and edge-case polish—install via pip for small teams now, watch for production use. Practical for git analytics if you're tired of `git log --author=foo | grep bar`.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.