grassmaker

A CLI that fills your GitHub contribution graph by generating git commits

한국어 | English

Warning

• This tool creates real commits in the repository where it is run.
• Only run it in a dedicated grass repository that you can discard.

Quick Start

Run it with npx, no installation required

mkdir grass && cd grass
npx grassmaker init

grass is just an example directory name. init runs git init, creates the data file, makes an initial commit, and guides you through connecting origin.

Create an empty repository on GitHub, then connect it

git remote add origin <repository URL>
git push -u origin main

Usage

Interactive Mode

npx grassmaker

Flow: language (한국어/English) → mode (total count/daily range) → commit count → date (today/fixed/period) → push → confirm

One-line Commands

npx grassmaker --count 7 --push
npx grassmaker --min 1 --max 3 --start 2026-01-01 --end 2026-12-31
npx grassmaker --dry-run

Options

• init: Initialize the current folder as a grass repository
• --count <number>: Total number of commits to generate
• --min/--max <number>: Range of commits per day (must be used together)
• --date <YYYY-MM-DD>: Generate all commits on the same date
• --random-date: Generate commits on random dates within the period
• --start/--end <YYYY-MM-DD>: Target period (must be used together)
• --data-file <path>: File to modify for each commit (default: data/logs.jsonl)
• --dry-run: Print the plan without creating actual commits
• --push: Push to origin after committing
• --branch <name>: Branch to push to (default: current branch)

--count and --min/--max cannot be used at the same time.

.env

Copy .env.example to .env to use the values as defaults (CLI arguments take precedence)