🚀 gitdrip

Automatically commit and push code with AI-generated messages

🧠 Powered by OpenRouter · 🛠️ Made with Node.js

---

✨ What is gitdrip?

gitdrip is a lightweight CLI tool that:
- Auto-stages your Git changes
- Uses AI to generate clean commit messages based on your git diff
- Pushes commits to the remote repo
- Supports managing and pushing multiple repositories at once
- Stores your OpenRouter API key securely
- NEW: SSH key generation and GitHub integration
- NEW: Background daemon mode for automatic commits
- NEW: Auto-start setup for system integration

> Say goodbye to "final-final-fix-2" commits 😄

---

📦 Installation

``bash
npm install -g gitdrip
`

> Requires Node.js 18+

---

🔧 Setup

First, set your OpenRouter API key and SSH configuration:

`bash
gitdrip setup
`

This will:
- Prompt for your OpenRouter API key
- Generate SSH keys if not present
- Open GitHub SSH settings page in your browser
- Trust GitHub's SSH host

---

🚀 Usage

$3

`bash
gitdrip push
`

Stages all changes, generates an AI commit message, and pushes to origin.

---

$3

`bash
gitdrip push --all
`

Loops through all added repos and performs the same commit + push operation.

---

📂 Repo Management

Use the repo namespace to manage your tracked repositories:

$3

`bash
gitdrip repo add /path/to/repo
`

Adds a single Git repo to be managed.

---

$3

`bash
gitdrip repo scan /path/to/parent-folder
`

Recursively finds all .git folders and adds them as managed repos.

---

$3

`bash
gitdrip repo remove /path/to/repo
`

Removes a single repo from the managed list.

---

$3

`bash
gitdrip repo remove --all
`

Clears the list of all managed repos.

---

$3

`bash
gitdrip repo list
`

Displays all currently tracked repositories.

---

🔄 Background Operations

$3

`bash
gitdrip daemon
`

Runs gitdrip in the background, automatically committing and pushing changes every 6 hours (configurable).

---

$3

`bash
gitdrip setup-autostart
`

Sets up gitdrip to automatically start on system login:

- Linux: Creates a systemd user service
- macOS: Provides instructions for LaunchAgent setup
- Windows: Provides instructions for Task Scheduler setup

---

🧠 How It Works

* Uses simple-git to interact with local repos
* Generates commit messages via OpenRouter + OpenAI models
* Diff is trimmed to 4000 characters to stay within token limits
* Stores configuration in ~/.gitdrip/config.json
* NEW: Automatically generates and configures SSH keys for GitHub
* NEW: Background daemon runs scheduled commits every 6 hours
* NEW: System integration for auto-start on login

---

📚 Commands Summary

| Command | Description |
| ---------------------------- | --------------------------------- |
| gitdrip setup | Set your OpenRouter API key & SSH |
| gitdrip push | Commit and push the current repo |
| gitdrip push --all | Commit and push all managed repos |
| gitdrip daemon | Run gitdrip in background mode |
| gitdrip setup-autostart | Setup auto-start on system login |
| gitdrip repo add | Add a single repo |
| gitdrip repo remove [path] | Remove a repo |
| gitdrip repo remove --all | Remove all repos |
| gitdrip repo scan