Skip to main content
Home
Browse packagesDocsSign in

@gitfill/gitfill@0.3.0
Built and signed on GitHub Actions

latest
frankdierolf/gitfill
Works with
This package works with DenoIt is unknown whether this package works with Cloudflare Workers, Bun
It is unknown whether this package works with Cloudflare Workers
This package works with Deno
It is unknown whether this package works with Bun
•JSR Score100%•
Published2 months ago (0.3.0)

Generate fake commits to fill your GitHub, GitLab, or Gitea contribution graph

gitfill

Generate fake commits to fill your contribution graph. Works with GitHub, GitLab, and Gitea.

Why

  • Lost access to an old account
  • Years of commits on GitLab, Bitbucket, or self-hosted instances
  • Client work on private enterprise repos
  • The work happened. The green squares didn't.

This fixes that.

Quick Start

mkdir my-commits && cd my-commits && git init
deno run jsr:@gitfill/gitfill --goal 1500

Or install globally:

deno install -g -n gitfill jsr:@gitfill/gitfill
gitfill --goal 1500

Usage

# Generate commits to reach your goal
gitfill --goal 1772

# Plan: see what your graph will look like before generating
gitfill --plan --goal 1772

# Audit: see fake vs real commit breakdown after push
gitfill --audit

# Specify platform
gitfill --goal 2000 --platform gitlab

# Dry run (no commits created)
gitfill --goal 1772 --dry-run

Both --plan and --audit open a local server with an interactive graph.

Options

Option Description
--goal <n> Target total commits (required)
--user <username> Username (default: auto-detect from git remote)
--platform <name> Platform: github, gitlab, gitea (default: auto-detect)
--host <hostname> Self-hosted instance (e.g., gitlab.mycompany.com)
--start <YYYY-MM-DD> Start date (default: account creation)
--end <YYYY-MM-DD> End date (default: today)
--max-per-day <n> Maximum commits per day (default: 175)
--yes, -y Skip confirmation
--dry-run Preview without creating commits
--plan See what your graph will look like (requires --goal)
--audit See fake vs real commit breakdown after push
--help, -h Show help
--version, -v Show version

How It Works

  1. Fetches your real contribution count from the platform's public API
  2. Calculates how many fake commits are needed to reach your goal
  3. Picks ~40% of days randomly as "active" (rest stay empty for realism)
  4. Distributes commits using Zipf's Law with randomized parameters:
    • Formula: commits = C / rank^α where α varies 0.9-1.1
    • Creates natural "few peaks, many small" pattern
    • Days are shuffled randomly across the date range
  5. Creates empty commits with backdated timestamps
  6. Push to your platform and watch your contribution graph fill in

Commit messages are simple: "update", "fix", "wip", "chore", "tweak".

Platform Support

Platform Auto-detect Self-hosted
GitHub Yes No
GitLab Yes Yes
Gitea/Codeberg Yes Yes

Requirements

  • Deno runtime
  • Git repository (can be empty)

License

MIT

Built and signed on
GitHub Actions
View transparency log

Report package

Please provide a reason for reporting this package. We will review your report and take appropriate action.

Please review the JSR usage policy before submitting a report.

Add Package

deno add jsr:@gitfill/gitfill

Import symbol

import * as gitfill from "@gitfill/gitfill";
or

Import directly with a jsr specifier

import * as gitfill from "jsr:@gitfill/gitfill";

Add Package

bunx jsr add @gitfill/gitfill

Import symbol

import * as gitfill from "@gitfill/gitfill";