ga - git agent

AI-powered CLI tool that automatically generates Conventional Commit messages for your Git commits.

Quick Start

npm install -g @kazuito/ga

Set your Google Generative AI API key:

# ~/.zshrc or ~/.bashrc
export GOOGLE_GENERATIVE_AI_API_KEY="your-api-key-here"

Get your API key from Google AI Studio.

Usage

Basic Usage

Stage your changes and generate a commit:

git add .
ga commit

You can also use the shorter aliases:

ga c
# or
ga ci

Stage All Changes

To automatically stage all changes before committing:

ga commit --add-all
# or
ga commit -a

The tool analyzes your staged changes, generates a Conventional Commit message, and creates the commit automatically.

Check API Key

Check if your Google Generative AI API key is valid:

ga check

This command tests your API key connection and provides clear feedback if there are any issues.

Features

• AI-Powered: Uses Google's Gemini Flash Lite to generate commit messages
• Safety Checks: Detects potential secrets (API keys, tokens, certificates, SSH keys, env vars, passwords) and prompts for confirmation before committing
• Conventional Commits: Follows the Conventional Commits specification
• Smart Formatting: Concise messages (max 72 characters) focused on intent

Requirements

• Node.js 18+
• Git
• Google Generative AI API key

License

MIT