Git Aic

git-aic is a command-line interface (CLI) tool built in TypeScript that upgrades your Git workflow by automatically generating high-quality, conventional commit messages.

Powered by Google Gemini, it analyzes your staged code changes and produces concise, descriptive, and standard-compliant commit messages, helping you maintain a clean and consistent Git history.

You define the rules.
You customize the system prompt.
You decide when it runs.

Your workflow. Your control.

Features

• AI-Powered Message Generation
  Uses Google Gemini API to generate commit messages from your Git diff.

• Self-Hosted & On-Demand
  Runs locally in your terminal. No background processes. No editor lock-in.

• Full Control Over Rules
  Modify the system prompt to enforce your own commit conventions and formatting style.

• Flexible Prompt Management
  Edit prompts globally or per repository, and set them from your editor, direct text, or a file.

• Conventional Commits Compliance
  Strictly follows formats like feat:, fix:, refactor:, chore:.

• Commit Confirmation & Editing
  Before committing, you can:

  • Accept the suggested commit message
  • Edit the full message in your editor
  • Reject it
  • Retry generation

• Issue Linking
  Attach commits to GitHub issues with --issue <number>.

• Optional Push After Commit
  Use -p or --push to push after committing.

• Config Management
  Set your Gemini API key or view your config:

  • git aic config --key <key>
  • git aic config

• TypeScript & Type Safety
  Built with TypeScript for maintainability and reliability.

• Seamless Git Integration
  Directly integrates with Git using a CLI.

Why Not Just Use Copilot?

Many AI commit tools:

• Depend on editor integrations
• Limit customization
• Enforce their defaults
• Restrict usage
• Run continuously in the background

This tool is different.

It runs only when you call it.
It follows your prompt rules.
It generates commits exactly how you define them.
It stays out of your way.

There are no forced conventions.
No hidden behavior.
No unnecessary background processes.

If needed, you can rotate API keys later. You stay in control.

This is controlled automation — not passive AI assistance.

User Installation

To install git-aic globally via npm:

npm i -g git-aic

git aic --help

Developer Installation (For Contributors)

1. Clone the Repository

git clone https://github.com/Spectra010s/git-aic.git
cd git-aic

2. Install Dependencies

npm install

3. Build the Project

npm run build

Configuration

Set API Key (Primary)

Use the CLI config command to save your Google Gemini API key:

git aic config --key <your_api_key>

To view your current config:

git aic config

Note: It is masked by default for security reasons.

To view the full saved API key:

git aic config --show

Environment Variable (Fallback)

If you prefer not to use the config system, you can set it manually in your environment:

• macOS / Linux:

export GEMINI_COMMIT_MESSAGE_API_KEY=your_api_key_here

• Windows (PowerShell):

setx GEMINI_COMMIT_MESSAGE_API_KEY "your_api_key_here"

After setting the variable, restart your terminal.

Note: This method works, but using the CLI config is safer and easier for long-term usage.

Usage

Commit With AI Assistance

git aic

• Prompts you with a generated commit message.
• You can accept, edit, reject, or retry the message.
• Editing opens your editor and supports multiline commit messages.

Commit and Link to Issue

git aic --issue 123

• Attaches the commit to GitHub issue #123.

Commit and Push

git aic -p

• Pushes automatically after committing.

Configure API Key

git aic config --key <key>

• Saves your Google Gemini API key.

git aic config

• Displays your saved config.

Manage Prompts

Edit the global prompt:

git aic prompt edit

Set the global prompt directly from text:

git aic prompt edit --text "Write concise conventional commits with a short body when needed."

Load the global prompt from a file:

git aic prompt edit --file ./prompt.txt

Reset the global prompt:

git aic prompt reset

Edit a repository-local prompt:

git aic prompt edit --local

Set a repository-local prompt from text:

git aic prompt edit --local --text "Use a short subject and a clear explanatory body."

Load a repository-local prompt from a file:

git aic prompt edit --local --file ./commit-prompt.txt

Reset the local prompt:

git aic prompt reset --local

Prompt resolution order:

1. local prompt from Git config
2. global prompt from Git-AIC config
3. built-in default prompt

How It Works

1. Captures your staged Git diff
2. Builds a strict system prompt
3. Resolves the active prompt from local, global, or default settings
4. Sends the prompt and diff to Gemini
5. Prompts for commit confirmation (accept, edit, retry, reject)
6. Opens your editor when you choose to edit the generated message
7. Executes git commit automatically
8. Optionally pushes if -p flag is used

---

Technologies Used

Technology	Purpose
TypeScript	Core language
Node.js	Runtime
Axios	HTTP client
Chalk	Styled terminal output
Commander.js	CLI framework
Simple-Git	Git integration
Google Gemini API	LLM text generation

Final Takeaway

Automating repetitive tasks like commit messages saves time — but the real win here is ownership.

git-aic:

• Self-hosted — runs entirely on your machine
• On-demand — only runs when you call it
• Fully customizable — prompts, commit format, workflow
• Under your control — you decide every step

It runs when you need it, follows your rules, and generates commits the way you want.

Choose your model. Define your prompt. Control the format. Extend or optimize anytime.

Instead of adapting to someone else's defaults, you built a system tailored to your workflow.

You are not just using AI tools.
You are building them to fit your process.

License

ISC License

Author

Spectra010s

• Twitter
• LinkedIn

Parent Repository

This project is a fork and standalone version of:

https://github.com/samueltuoyo15/Commit-Message-Tool