Skip to content

GitIntel

GitIntel is a command-line tool that reads a Git repository's history and turns it into three concrete answers:

  • What happened in this repository? — commits, contributors, activity, and health signals.
  • Who owns this code? — per-file ownership by modification count, lines changed, and last touch.
  • Where is the risk? — hotspot files ranked by churn, contributor spread, and ownership clarity.

Everything runs locally against the Git object database. There is no server, no account, no API token, and no telemetry.

pipx install gitintel
gitintel analyze .

What GitIntel is

GitIntel is a Python 3.11+ CLI built on pygit2 (libgit2 bindings), Typer, and Rich. It walks the commit graph from HEAD, computes per-file change statistics, and renders reports as terminal tables, JSON, or Markdown.

It works on a local checkout or on a public GitHub URL, which it clones into a local cache before analyzing.

Key features

Capability Command Details
Repository summary, contributors, most-changed files, health signals analyze Analyzing repositories
Per-file ownership by modifications, lines changed, last modifier ownership Ownership analysis
Risk-scored hotspot files with human-readable reasons hotspots Hotspot analysis
table, json, and markdown output --format Output formats
Local paths and GitHub URLs, with an on-disk clone cache any command Repository sources and cache
Short alias gitit for every command — Installation

Who it is for

  • Reviewers and maintainers deciding who should review a change, or which files deserve extra scrutiny.
  • Tech leads looking for bus-factor and ownership-concentration risk before planning work.
  • Contributors joining a new codebase who need to know which files matter and who to ask.
  • Automation authors who want repository statistics as JSON or Markdown inside CI.

See Use cases for worked examples.

Where to start

  • :material-rocket-launch: New here?

    Install GitIntel and run your first report in a few minutes.

    Getting started

  • :material-lightbulb-on: Want the mental model?

    Learn how commits become ownership and hotspot metrics.

    Core concepts

  • :material-console: Need exact flags?

    Every command, argument, option, and output field.

    CLI reference

  • :material-code-braces: Contributing?

    Set up the repo, run tests, and add a command.

    Developer guide

Project status

GitIntel is at version 0.1.0 (Beta). The CLI surface is small and stable, but the metric definitions and JSON field names may still change before 1.0.0. See Versioning and releases for the compatibility policy and Documentation roadmap for what is planned next.

Licensed under the MIT License.