giannisp/git-contrib-calendar

Experimental git contributions calendar for the terminal (built with NodeJS, React and Ink).

43

stars

171

commits

JavaScript

primary language

May 2, 2026

updated

cli
cli-app
contributions-calendar
git
ink
react
Browse cluster: Ink CLI component library

README

git-contrib-calendar

screenshot

This is an experimental git contributions calendar running on the terminal for any local repository.

The interface is inspired by the famous GitHub profile contributions graph, where each block represents a single day, and the color shade depends on the number of commits for that particular day.

Install

npm i -g git-contrib-calendar

Run for git repository on the current path

git-contrib-calendar

CLI options

-p, --path     Path to any local git repository (example: -p /path/to/repo)
-a, --author   Filter git commits by author (example: -a John)
-y, --year     Display git commits for a specific year (example: -y 2018)
-v, --version  Display the app version
-h, --help     Display help

Under the hood

  • Node
  • Ink
  • React
  • ESLint
  • Prettier
  • Commander CLI

Contributors

giannisp

171 commits

giannisp/git-contrib-calendar

Experimental git contributions calendar for the terminal (built with NodeJS, React and Ink).

43

stars

171

commits

JavaScript

primary language

May 2, 2026

updated

cli
cli-app
contributions-calendar
git
ink
react
Browse cluster: Ink CLI component library

README

git-contrib-calendar

screenshot

This is an experimental git contributions calendar running on the terminal for any local repository.

The interface is inspired by the famous GitHub profile contributions graph, where each block represents a single day, and the color shade depends on the number of commits for that particular day.

Install

npm i -g git-contrib-calendar

Run for git repository on the current path

git-contrib-calendar

CLI options

-p, --path     Path to any local git repository (example: -p /path/to/repo)
-a, --author   Filter git commits by author (example: -a John)
-y, --year     Display git commits for a specific year (example: -y 2018)
-v, --version  Display the app version
-h, --help     Display help

Under the hood

  • Node
  • Ink
  • React
  • ESLint
  • Prettier
  • Commander CLI

Contributors

giannisp

171 commits

Languages

JavaScript

100.0%