Skip to content
All four analyses

Analysis

Project Evolution: your Git history as a film

Where the comparison shows two photographs, Project Evolution plays the movie: the chart walks your history commit by commit, from the first revision to the current state of the branch.

  • The timeline is sampled evenly in time, favouring merges and tags, or you pick a range or the exact commits.
  • Play, pause, step, change speed, jump anywhere on the timeline.
  • Every frame is a full analysis, stamped with its commit and date.
A frame of the evolution movie on the amber table

Project Evolution in XR

Watch on YouTube

How to read it

Where the comparison shows you two photographs, Project Evolution plays the movie. The chart walks your repository’s own history commit by commit, from the first revision to the current state of the branch, and you watch the shape of the project change.

Every frame is a full analysis, stamped with the commit and the date it belongs to. Nothing is interpolated between commits: what you see at any point on the timeline is what the code actually measured then. Each frame also keeps your current chart mapping, so whatever you set up in the classic analysis carries straight over into the film.

You build the timeline first, then play it: play, pause, step a frame at a time, change the speed, or jump anywhere. It is the analysis for questions no single snapshot answers: when complexity started climbing, which directory grew fastest, whether a refactor actually shrank anything.

Three ways to build the timeline

  • Auto: commits sampled evenly in time, favouring merges and tags
  • Range: you choose the span of history to walk
  • Manual: you pick exactly the commits you want

XR only: Project Evolution runs in the XR scene. Unlike the file, dependency and history analyses, it has no 2D LivePanel counterpart.

What the player gives you

The controls sit on a panel inside the scene, next to the table the film plays on.

Timeline modes
Auto, Range and Manual: how the frames get chosen in the first place.
The frame list
Every frame in the built timeline, so you can see and jump to any of them.
Generate movie
Builds the timeline into a film before you play it.
Transport
Play, pause and step, plus seeking anywhere along the timeline.
Playback speed
How fast the history runs, adjustable while it plays.

What the numbers mean

These are the extension’s own definitions: the same glossary the in-room guide shows, generated from the real analysis contracts.

Frame
One commit, rendered as a full analysis scene.
Timeline
Auto picks the commits for you; range and manual are yours.
Frame data
The directory metrics, recomputed for each commit in the timeline.
Playback
Play, pause and seek, at an adjustable speed.

The film

Every frame is a full analysis, stamped with the commit it belongs to.

The controller

Timeline modes, the frame list, transport buttons and playback speeds.

The in-room guide

The walkthrough and the metric glossary for the evolution.

That is one of the four analyses. They all come from the same extension, and the same install.

Install it and run it