By Prince Kumar•2026-06-01•4 min read
Ghost Engineer: The Tool That Fakes Your GitHub Graph
PythonGitAutomationTools
Let's be honest — everyone wants a green GitHub graph. But maintaining daily contributions while juggling coursework and freelance work is hard. So I built Ghost Engineer.
What It Does
Ghost Engineer fills your GitHub contribution graph with realistic backdated commits. It:
- Creates fake source files in a temporary folder
- Pushes them with carefully distributed timestamps
- Auto-deletes everything after pushing
- Supports Linux, Windows, and macOS
The Engineering
Time Distribution
Random timestamps aren't convincing. I built a distribution algorithm that:
- Concentrates commits during weekdays
- Adds occasional weekend activity
- Maintains natural-looking gaps
Safety Features
- All files are created in a `_ge/` folder
- Automatic cleanup after push
- No modification of existing files
- Git history can be reviewed before pushing
Why I Built It
Not to be dishonest — but to understand how Git internals work. Building this tool taught me more about git plumbing, force pushing, and commit trees than any tutorial ever could.