gac (Git Auto Commit)

gac is a high-performance command-line interface (CLI) tool designed to automate Git workflows using Artificial Intelligence. It analyzes repository changes, generates structured commit messages using OpenRouter-compatible models, and manages remote repository synchronization within a unified execution flow.

Features

• AI-Driven Message Generation: Analyzes staged changes (diffs) to generate structured messages adhering to the Conventional Commits specification.
• Remote Synchronization: Automatically executes git fetch to detect remote updates and prompts for a pull operation when the local branch is behind, preventing merge conflicts.
• Interactive Staging: Automatically detects unstaged changes and prompts to stage all files when no changes are currently indexed.
• Post-Commit Workflows: Optional prompts for immediate push operations and Pull Request (PR) creation on GitHub for non-main branches.
• Advanced Diff Filtering: Automatically excludes lock files (e.g., bun.lock, package-lock.json) and system noise to optimize AI context and token efficiency.
• Configurable Styles: Supports multiple commit styles, including conventional, detailed, and minimal.
• Extensibility: Support for custom system prompts and repository-specific ignore rules via .gacignore.

Installation

Via npm

npm install -g gac-cli

From Source

git clone https://github.com/ravvdevv/gac.git
cd gac
bun install
bun link

Configuration

Initial setup requires an OpenRouter API key:

gac --key <YOUR_API_KEY>

To set the preferred AI model (Default: arcee-ai/trinity-large-preview:free):

gac --model <MODEL_ID>

Usage

Basic Execution

Run gac in any Git repository to initiate the automated commit workflow:

gac

Amending Commits

To regenerate the commit message for the most recent commit:

gac --amend

Dry Run and Clipboard Integration

To generate a message without executing a commit:

gac --dry-run

To copy the generated message directly to the system clipboard:

gac --copy

Command Options

| Option | Description | | :--- | :--- | | --no-sync | Disable remote update checks (offline mode). | | --no-verify | Skip Git pre-commit hooks. | | --style <style> | Override the default commit style. | | --prompt <text\|path> | Specify a custom system prompt or prompt file. |

Hook Installation

To install a pre-commit hook that invokes gac automatically:

gac install-hook

Project Configuration

.gacignore

The .gacignore file in the repository root allows for excluding specific files from AI analysis using standard glob patterns.

Model Selection

gac supports all OpenRouter-compatible models. Use gac --model custom to specify a custom model ID.

License

This project is licensed under the Raven License. Refer to the LICENSE file for complete terms.

Maintained by Raven