https://github.com/rahil1202/let-him-commit
The package for doing git commit but in history
https://github.com/rahil1202/let-him-commit
commit git github history javascript nodejs npm npm-package
Last synced: 2 months ago
JSON representation
The package for doing git commit but in history
- Host: GitHub
- URL: https://github.com/rahil1202/let-him-commit
- Owner: rahil1202
- License: apache-2.0
- Created: 2025-10-18T13:11:45.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-20T07:44:07.000Z (8 months ago)
- Last Synced: 2025-10-27T08:13:58.741Z (8 months ago)
- Topics: commit, git, github, history, javascript, nodejs, npm, npm-package
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/let-him-commit
- Size: 50.8 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
# 🍳 Hold Up! Let-Him-Commit
**By [Rahil Vahora](https://github.com/rahil1202)**
_“Because sometimes, you just gotta let him commit...”_
---
## 🔧 What is this?
**Let-Him-Commit** is a fun yet educational CLI tool that automates **GitHub commit generation** and let you commit in the **Past, yes you can commit in the past/history**—
think of it as your *Git time machine*.
It helps you learn how automation, APIs, and date-based commit scripting work, all while producing beautiful commit graphs.
> ⚠️ **Disclaimer:** This is for **educational purposes only**.
> Do **not** use it to mislead others or fake contributions.
> Always use your **own GitHub account** and **private repos**.
---
## 🚀 Quick Start
You can use **Let-Him-Commit** directly with npm — no cloning required!
### 🔹 Option 1: Run instantly using NPX
```bash
npx let-him-commit
````
### 🔹 Option 2: Install globally
```bash
npm install -g let-him-commit
```
Then just run:
```bash
let-him-commit
```
### 🔹 Option 3: Clone manually
If you want to explore or modify the source code:
```bash
git clone https://github.com/rahil1202/let-him-commit.git
cd let-him-commit
npm install
npm run start
```
---
## ⚙️ How It Works
1. The tool clones or creates a **private repository** (default: `let-him-cook` 🍳).
2. It generates **commits across selected dates** using a customizable commit range (default: 2–5 per day).
3. Each commit message is templated — you can customize or randomize it.
4. It automatically pushes commits in controlled batches to prevent GitHub rate limits.
5. You get a **beautiful commit history** in minutes.
---
## 💡 Example Usage
```bash
let-him-commit
```
Then follow the prompts to:
* Paste your **GitHub Personal Access Token**
* Enter a **repo name** (`let-him-cook` by default)
* Select **start & end dates**
* Set a **commit range per day**
* Confirm and watch the magic happen ✨
---
## 🎯 Educational Goals
* Learn how to automate Git commits using Node.js and TypeScript
* Understand GitHub API integration and repo automation
* Practice CLI UX design and prompt flows
* Explore date-based scripting and commit batching
---
## 🧩 Tech Stack
* **Node.js + TypeScript**
* **Inquirer** for CLI interaction
* **Axios** for GitHub API calls
* **Chalk** for colored terminal output
* **CLI-Progress** for progress visualization
* **Zod** for input validation
---
## 🧱 Repo Info
This repository (`let-him-cook`) is automatically generated by **Let-Him-Commit**.
It demonstrates backdated commit creation for learning and experimentation.
---
## 🪪 License
**Apache License** © 2025 [Rahil Vahora](https://github.com/rahil1202)
---
## 💬 Contributing
Want to improve this or add new features (like funky commit messages or new templates)?
Pull requests are welcome! 🙌
👉 [GitHub Repository](https://github.com/rahil1202/let-him-commit)
---
## ❤️ Fun Fact
> “Give a dev a repo, and he commits for a day.
> Teach a dev to automate commits, and he’ll let him commit forever.” 😎
---