⚠️ WARNING: Use with caution!If you commit to a past year, your GitHub contribution graph will show those commits for that year—even if you later delete the repository. This is a permanent visual change for that year! Always use a private repository named like
timelineYYYY(e.g.,timeline2010) for each year.
Turn your GitHub contribution graph into a playground! Write up to 8-character words or draw shapes on your timeline using automated commits. Make your year a work of art, a meme, or a secret message! 🌈✨
- 🟩 Draw words or shapes on your GitHub timeline for any year
- 🕹️ Full CLI control: pick year, word, commit randomness, and more
- 🎲 Randomized commit mode for natural-looking activity
- 🖼️ Preview your timeline before you commit (with color!)
- 🛡️ Safety checks and warnings for your GitHub history
- 🤩 Terminal-based visual fun before you push!
git clone https://github.com/husamettinarabaci/gitGraffiti.git
cd gitGraffiti
go mod tidy # Install dependenciesgo run main.go -repo=<REPO> -user=<USER> -word=<WORD> -year=<YEAR>- Draws on your contribution graph.
- You can use up to 8 characters (A-Z, a-z, 0-9).
- The tool will preview the timeline and ask for confirmation before pushing.
go run main.go -repo=<REPO> -user=<USER> -start=<START_DATE> -end=<END_DATE>- Fills your timeline with random commit activity.
- Customize with
-min-days,-max-commits,-weekend, etc.
- Create a private repo for each year:
- Name it like
timeline2010,timeline2011, etc. - Set it to private to avoid polluting your public profile.
- Name it like
- Preview before you commit:
- The tool shows a color preview and asks for confirmation.
- Run the tool:
- Use the CLI as shown above.
- Never delete the repo if you want to remove the timeline art!
- Deleting the repo does not remove the timeline art for that year from your GitHub profile.
-word=HI -year=2022draws HI in your 2022 timeline-word=LOVE -year=2023draws LOVE in your 2023 timeline-word=2025 -year=2025draws 2025 in your 2025 timeline- Random mode fills your year with a unique, organic pattern!
-min-days/-max-commits— Control density of random commits-weekend=false— Exclude weekends-start-hour/-end-hour— Set commit time window
- To remove a timeline art, you must manually rewrite your GitHub history. Deleting the repo is not enough!
- Always use private repos for experiments.
MIT
PRs, issues, and new art ideas are welcome! Open an issue or submit a pull request.