✨ 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

npm install -g gitdrip

Requires Node.js 18+

🔧 Setup

First, set your OpenRouter API key and SSH configuration:

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

🔁 Push Current Repo with AI Commit

gitdrip push

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

🔁 Push All Tracked Repos

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:

➕ Add a Repo

gitdrip repo add /path/to/repo

Adds a single Git repo to be managed.

🔍 Scan and Add All Git Repos in a Directory

gitdrip repo scan /path/to/parent-folder

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

🧹 Remove a Repo

gitdrip repo remove /path/to/repo

Removes a single repo from the managed list.

🔥 Remove All Managed Repos

gitdrip repo remove --all

Clears the list of all managed repos.

📋 List All Managed Repos

gitdrip repo list

Displays all currently tracked repositories.

🔄 Background Operations

🖥️ Run Daemon Mode

gitdrip daemon

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

🚀 Setup Auto-Start

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 <path> | Add a single repo | | gitdrip repo remove [path] | Remove a repo | | gitdrip repo remove --all | Remove all repos | | gitdrip repo scan <dir> | Scan a directory for Git repos | | gitdrip repo list | Show all managed repos |

🔧 Configuration

Daemon Frequency

The daemon runs every 6 hours by default. You can modify this by editing ~/.gitdrip/config.json:

{
  "repos": ["/path/to/repo1", "/path/to/repo2"],
  "frequency": 6
}

Logs

Daemon logs are stored in ~/.gitdrip/gitdrip.log for monitoring background operations.

📄 License

MIT © 2025 Priyanshu Chaurasia

💡 What's Next?

• [ ] Add git pull before commit option
• [ ] Support for .gitignore parsing
• [ ] Add support for .gitdriprc config overrides
• [ ] Custom AI model selection
• [ ] Webhook notifications for failed commits
• [ ] Branch-specific commit strategies

🌟 Like the project?

• Leave a ⭐ on GitHub
• Share it on socials!
• Contribute or file issues to make it better 💥