@chamax/git-timetraveler
v0.1.0
Published
Create GitHub repositories with backdated commits to show early years in your profile
Maintainers
Readme
@chamax/git-timetraveler
🚀 Travel back in time on your GitHub profile!
This npm package provides easy installation of the Git Time Traveler CLI tool.
Quick Start
# Run directly with npx (recommended)
npx @chamax/git-timetraveler --year 1990
# Or install globally
npm install -g @chamax/git-timetraveler
git-timetraveler --year 1990What it does
Creates GitHub repositories with backdated commits to show early years in your contribution graph. This is a modern, cross-platform rewrite of the original 1990-script in Rust.
Features
- 🦀 Rust-powered: Fast, reliable, and memory-safe
- 🌍 Cross-platform: Works on macOS, Windows, and Linux
- 🎨 Beautiful CLI: Interactive prompts with progress bars
- 📅 Flexible dates: Customize year, month, day, and hour
- 🔒 Secure: Uses GitHub personal access tokens
Usage
# Interactive mode
npx @chamax/git-timetraveler
# Custom date and time
npx @chamax/git-timetraveler --year 1985 --month 10 --day 26 --hour 9
# Non-interactive mode
npx @chamax/git-timetraveler --username johndoe --token ghp_xxxx --year 1990 --yes
# Get help
npx @chamax/git-timetraveler --helpInstallation
This package automatically downloads the appropriate binary for your platform during installation:
- macOS: Intel and Apple Silicon support
- Windows: x64 support
- Linux: x64 support
No additional dependencies required!
Requirements
- Create a repository on GitHub with the year as the name (e.g.,
1990) - Generate a personal access token:
- Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
- Click "Generate new token (classic)"
- Select scopes:
repo(Full control of private repositories) - Copy the generated token
Repository
- Source: chama-x/Git-Timetraveler
- Issues: Report bugs
- Releases: Download binaries
License
MIT © chama-x
