news · Barcelona

Every Repo Has a Shape

Every Repo Has a Shape

There is a tool called codebase-posters. You run one command inside any git repository and your browser opens an exhibition of nineteen posters, painted live from your commit history.

The additions and deletions become storms. Your working days become a calendar. The project's heartbeat shows up as a line. The commits you made at two in the morning form constellations.

It is deterministic. It runs locally. Zero dependencies. The whole thing is about a hundred kilobytes. One command:

npx codebase-posters

The interesting thing is not that a tool can draw your repo. The interesting thing is that a repository has a visible shape to begin with — that thirteen years of a codebase like React reads as a weather pattern, that Express has been raining since 2009, that your sleep schedule is written in the geometry of your commits. The work was already there. This just points a light at it.

Made by @unable0_.