gitc

✨ gitc - AI-Powered Git Commit Messages

gitc is a fast, lightweight CLI tool that uses AI to generate clear, consistent, and standards-compliant commit messages — directly from your Git diffs. With built-in support for Conventional Commits, Gitmoji, and fully customizable rules, gitc helps you and your team write better commits, faster

🚀 Features

gitc is a lightweight CLI tool that leverages AI to craft clear, standards-compliant Git commit messages from your diffs. Supporting Conventional Commits, Gitmoji, and custom rules, it saves time and boosts commit quality for you and your team.

• 🧠 AI-Powered Commits

  • Generates context-aware commit messages using OpenAI, Grok (xAI), or DeepSeek.
  • Supports multiple languages (e.g., English, Persian, Russian) for global teams.
  • Extensible for future AI providers like Gemini.

• 📝 Standards & Customization

  • Follows Conventional Commits (feat, fix, docs, etc.) for semantic versioning.
  • Adds Gitmoji emojis for visual flair (e.g., ✨, 🚑).
  • Customizable prefixes (e.g., JIRA IDs) via JSON.

• 🔧 Git Integration

  • Processes staged Git diffs, ignoring irrelevant files (node_modules/*, *.lock).
  • Configurable file exclusions for focused commits.

• ⚙️ Flexible Configuration

  • Supports CLI flags, environment variables, and ~/.gitc/config.json.
  • Includes proxy support, adjustable timeouts, and redirect limits.

• ⚡️ Performance & Reliability

  • Fast JSON parsing with sonic and HTTP requests with fasthttp.
  • Robust error handling for reliable operation.

• 🧪 Debug & Dry-Run

  • Preview prompts and configs without API calls — perfect for tuning without burning tokens.

📦 Installation

Prerequisites:

• Go: Version 1.18 or higher (required for building from source).
• Git: Required for retrieving staged changes.
• OpenAI API Key: Required for AI-powered commit message generation. Set it via the AI_API_KEY environment variable or in the config file.

Quick Install:

go install github.com/dll-as/gitc@latest

Manual Install

1. Download binary from releases
2. chmod +x gitc
3. Move to /usr/local/bin

Verify Installation

After installation, verify the tool is installed correctly and check its version:

gitc --version

💻 Basic Usage

# 1. Stage your changes
git add . # or gitc -a

# 2. Generate perfect commit message
gitc

# Stage specific files and generate
gitc bot.py
gitc src/utils.go main.go

# Pro Tip: Add emojis and specify language
gitc --emoji --lang fa

# Custom commit type
gitc --commit-type fix

# Debug mode: See what prompt would be sent without API cost
gitc --dry-run

Environment Variables

export OPENAI_API_KEY="sk-your-key-here"
export GITC_LANGUAGE="fa"
export GITC_MODEL="gpt-4"

⚙️ Configuration

Config File (~/.gitc/config.json) :

{
  "provider": "openai",
  "max_length": 200,
  "temperature": 0.7,
  "proxy": "",
  "language": "en",
  "timeout": 10,
  "commit_type": "",
  "custom-convention": "",
  "use_gitmoji": false,
  "max_redirects": 5,
  "open_ai": {
    "api_key": "sk-your-key-here",
    "model": "gpt-4o-mini",
    "url": "https://api.openai.com/v1/chat/completions"
  }
}

Update Configuration

gitc config --api-key "sk-your-key-here" --model "gpt-4o-mini" --lang en

📚 Full Options

The following CLI flags are available for the ai-commit command and its config subcommand. All flags can also be set via environment variables or the ~/.gitc/config.json file.

[!NOTE]

• Flags for the config subcommand are similar but exclude defaults, as they override the config file.
• Flags > Environment Variables > Config File — This is the order of precedence when multiple settings are provided.
• The --custom-convention flag expects a JSON string with a prefix field (e.g., {"prefix": "JIRA-123"}).
• The --version flag displays the current tool version (e.g., 0.3.0) and can be used to verify installation.
• The --all flag (alias -a) stages all changes in the working directory before generating the commit message, streamlining the workflow. For example, gitc -a --emoji stages all changes and generates a commit message with Gitmoji.
• Environment variables take precedence over config file settings but are overridden by CLI flags.
• You can reset all configuration values to their defaults by using gitc config gitc reset-config.

🤖 AI Providers

gitc is designed to be AI-provider agnostic. While it currently supports OpenAI out of the box, support for additional providers is on the roadmap to ensure flexibility and future-proofing.

ℹ️ We're actively working on supporting multiple AI backends to give you more control, flexibility, and performance. Have a provider you'd like to see? Open a discussion!

🤝 Contributing

We welcome contributions! Please check out the contributing guide before making a PR.

⭐️ Star History