README

Gen-AI Commit Analyzer

[](https://github.com/jonathanleahy/github-gen/actions/workflows/ci.yml) [](https://goreportcard.com/report/github.com/jonathanleahy/github-gen)

Gen-AI Commit Analyzer measures AI-generated code adoption across Git histories. The CLI clones repositories, detects // gen start / // gen end regions, tracks AI vs non-AI lines, and outputs per-commit and aggregated metrics for authors, squads, and tribes.

Quick Start

bash

go install github.com/jon-genai-analyzer/cmd/genai-analyzer@latest

genai-analyzer --repo https://github.com/org/project.git \
  --format sqlite \
  --output analytics.db \
  --cache-dir ~/.genai-cache \
  --aggregate-dimensions author,squad --aggregate-daily off

This produces analytics.db with commit_metrics and aggregate_metrics tables.

Key Features

Multi-repo analysis via manifests
Filters (--include, --exclude) for language/paths
Incremental caching with SQLite payloads per commit
Author normalization via .mailmap + authors.yaml
Aggregates configurable by dimension with optional daily breakdowns

See docs/user/guide.md and docs/user/walkthrough.md for detailed usage and sample outputs.

Sample Data

sample-data/sample-config.yml offers a ready-to-run configuration.
docs/reference/sample-data.md describes the bundled manifest and golden CSV outputs for testing.