Skip to main content

Project banner

git-chronoscope

git-chronoscope generates video or animated GIF visualizations showing how a Git repository evolves over time. Point it at a repo, and it produces a time-lapse of file creation, deletion, and modification across commits. A visual history of how a codebase grew, plateaued, got refactored, and grew again.

The Problem It Solves​

Git history is rich with information, but git log is a wall of text. Understanding how a project evolved--when major features were added, how the file structure changed, which areas of the codebase saw the most activity--requires either deep familiarity with the repo or a lot of manual detective work.

A filmstrip of repository evolution — five frames showing the codebase growing across versions.

A 30-second animation shows patterns that would take hours to extract from log output: the initial scaffolding phase, the period of rapid feature development, the refactoring pass that reorganized the directory structure, the contributor who touched every file in a single weekend. git-chronoscope makes that history visual and immediate.

What It Does​

Give it a local repository path or a remote URL to clone. It reads the commit history, reconstructs the file tree at each commit, and renders each one as a frame--visualizing creation, deletion, and modification with customizable resolution, frame rate, color schemes, author-based highlighting, branch filtering, and path-based inclusion or exclusion.

Tree ring cross-section: each ring is a time period, wider rings mean more commits.

Output formats include MP4 video, animated GIF, or HTML. The web interface provides real-time progress and a preview. Privacy controls let you redact author emails and exclude filenames or paths containing sensitive information, so you can share visualizations of private repos without leaking anything you shouldn't.

Technology​

  • Language: Python (77%), JavaScript/TypeScript
  • Interface: CLI and web GUI
  • Platforms: PyPI, Homebrew, npm, Docker, or from source
  • CI/CD: GitHub Actions integration
  • License: MIT

The chronoscope dashboard: file growth chart, contributor heatmap, and 24-hour commit clock.

How It Connects​

git-chronoscope complements the documentation-first philosophy in an unexpected way: it makes the history of a project visible. For projects like LlmsTxtKit or Lexichord where the documentation came before the code, a chronoscope visualization would literally show the docs directory populating before the source directory. The docs-first approach, made visible in the commit timeline.

Where to Find It​