gitstreak
v1.0.0
Published
Restore missing contribution days in your GitHub graph via backdated local commits.
Readme
gitstreak
Restore missing contribution days in your GitHub graph via backdated local commits.
Installation
$ npm install -g gitstreakUsage
Automatically restore gaps
The restore command detects the most recent gap in the last 30 days and executes a fix.
$ gitstreak restoreManual restoration
For specific dates, use the custom command with a defined date string.
Example:
$ gitstreak custom --date "2026-02-14" --message "feat: add heart banner"Options:
--date: Target date (YYYY-MM-DD)--time: Optional explicit time (HH:mm:ss)--message: Custom commit message (Default: "Restore status")
Internal Mechanics
The tool manipulates internal Git variables to backdate contributions:
GIT_AUTHOR_DATE: Sets the authorship timestamp.GIT_COMMITTER_DATE: Sets the commit timestamp.
Attribution
Developed by Favour Larence Ejiogu (Mello).
Follow on Twitter: Favour Larence Ejiogu (Mello)
