git-smart-commit-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emirhan Oğuz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# Git Smart Commit (ai-commit-cli)
+
+An AI-powered Git commit message generator. Stop writing repetitive commit messages and let AI generate conventional, descriptive commits for you based on your staged code changes.
+
+## Features
+- **Bring Your Own Key (BYOK):** Securely stores your free API key locally (`~/.ai-commit/config.json`).
+- **Google Gemini API Support:** Blazing fast generation using the latest Gemini models.
+- **Ollama Support (Coming Soon):** Generate commits locally with zero API keys or internet connection.
+- **Interactive UI:** Review, edit, or regenerate the commit message before applying it.
+
+## Installation
+
+*(Note: Currently in development. Global npm install coming soon.)*
+
+Clone the repository and install globally:
+```bash
+git clone https://github.com/yourusername/ai-commit-cli.git
+cd ai-commit-cli
+npm install
+npm link
+```
+
+## Setup
+
+First, configure your AI provider (Currently supports Google Gemini):
+
+```bash
+ai-commit config
+```
+
+You will be prompted to enter your Gemini API key.
+
+## Usage
+
+1. Stage your changes:
+```bash
+git add .
+```
+
+2. Run the tool:
+```bash
+ai-commit
+```
+
+The tool will analyze your `git diff --staged` and generate a commit message following the Conventional Commits specification.
+
+### Interactive Menu
+Once the message is generated, you will see a prompt:
+- **Accept and Commit:** Automatically runs `git commit -m "..."`
+- **Regenerate:** Asks the AI for another option
+- **Edit manually:** Opens an input field to tweak the AI's suggestion
+- **Cancel:** Aborts the commit
+
+## License
+MIT
+
+
+<!--    test  trigger   --> 
+.

package/ai.js

@@ -0,0 +1,46 @@
+import { GoogleGenerativeAI } from '@google/generative-ai';
+
+const PROMPT = `You are an expert developer. Generate a concise, conventional git commit message based on the provided git diff.
+Follow the conventional commits format (e.g., feat: ..., fix: ..., chore: ...).
+Do not include any explanation, markdown formatting, or quotes around the message. Just output the commit message string.
+
+Git diff:
+`;
+
+export async function generateCommitMessage(config, diff) {
+  const provider = config.provider || 'gemini';
+
+  if (provider === 'gemini') {
+    if (!config.apiKey) throw new Error('Gemini API key is missing. Run config first.');
+    const genAI = new GoogleGenerativeAI(config.apiKey);
+    
+    // Model fallback list in case of 503 High Demand errors
+    const modelsToTry = ["gemini-flash-latest", "gemini-pro-latest", "gemini-2.5-flash", "gemini-3.5-flash"];
+    let lastError = null;
+
+    for (const modelName of modelsToTry) {
+      try {
+        const model = genAI.getGenerativeModel({ model: modelName });
+        const result = await model.generateContent(PROMPT + diff);
+        return result.response.text().trim();
+      } catch (error) {
+        lastError = error;
+        // If it's a 503 or 500 error, continue to the next model
+        if (error.message && (error.message.includes('503') || error.message.includes('500') || error.message.includes('demand'))) {
+          console.log(`\nModel ${modelName} is busy, switching to fallback model...`);
+          continue;
+        }
+        // If it's a different error (like invalid key), throw immediately
+        throw new Error(`Failed to generate message from Gemini API (${modelName}): ` + error.message);
+      }
+    }
+    
+    throw new Error('All Gemini fallback models failed due to high demand. Please try again later. Last error: ' + lastError.message);
+  } 
+  
+  if (provider === 'ollama') {
+    throw new Error('Ollama provider is not fully implemented yet.');
+  }
+
+  throw new Error('Unknown AI provider selected.');
+}

package/config.js

@@ -0,0 +1,25 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.ai-commit');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+export function loadConfig() {
+  if (fs.existsSync(CONFIG_FILE)) {
+    try {
+      const data = fs.readFileSync(CONFIG_FILE, 'utf8');
+      return JSON.parse(data);
+    } catch (e) {
+      return {};
+    }
+  }
+  return {};
+}
+
+export function saveConfig(config) {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
+}

package/git-engine.js

@@ -0,0 +1,18 @@
+import { execSync, execFileSync } from 'child_process';
+
+export function getStagedDiff() {
+  try {
+    const diff = execSync('git --no-pager diff --staged', { encoding: 'utf8' });
+    return diff.trim();
+  } catch (error) {
+    throw new Error('Failed to run git diff. Are you in a git repository?');
+  }
+}
+
+export function commitChanges(message) {
+  try {
+    execFileSync('git', ['commit', '-m', message], { stdio: 'inherit' });
+  } catch (error) {
+    throw new Error('Failed to commit changes.');
+  }
+}

package/index.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { loadConfig, saveConfig } from './config.js';
+import { getStagedDiff, commitChanges } from './git-engine.js';
+import { generateCommitMessage } from './ai.js';
+
+program
+  .name('ai-commit')
+  .description('AI-powered git commit message generator')
+  .version('1.0.0');
+
+program
+  .command('config')
+  .description('Set up your Gemini API key')
+  .action(async () => {
+    const answers = await inquirer.prompt([
+      {
+        type: 'password',
+        name: 'apiKey',
+        message: 'Enter your Google Gemini API key:',
+        mask: '*'
+      }
+    ]);
+    const config = loadConfig();
+    config.apiKey = answers.apiKey;
+    saveConfig(config);
+    console.log(chalk.green('API Key saved successfully!'));
+  });
+
+program
+  .command('commit', { isDefault: true })
+  .description('Generate a commit message and commit')
+  .action(async () => {
+    const config = loadConfig();
+    if (!config.apiKey) {
+      console.log(chalk.red('Error: API key not found.'));
+      console.log(`Please run ${chalk.yellow('ai-commit config')} to set it up.`);
+      process.exit(1);
+    }
+
+    try {
+      const diff = getStagedDiff();
+      if (!diff) {
+        console.log(chalk.yellow('No staged changes found. Please stage your changes using "git add" first.'));
+        process.exit(0);
+      }
+
+      let message = '';
+      let accepted = false;
+
+      while (!accepted) {
+        console.log(chalk.blue('\nAnalyzing git diff...'));
+        message = await generateCommitMessage(config, diff);
+        
+        console.log('\n' + chalk.bold('Generated Commit Message:'));
+        console.log(chalk.green(message) + '\n');
+
+        const { action } = await inquirer.prompt([
+          {
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: [
+              { name: 'Accept and Commit', value: 'accept' },
+              { name: 'Regenerate', value: 'regenerate' },
+              { name: 'Edit manually', value: 'edit' },
+              { name: 'Cancel', value: 'cancel' }
+            ]
+          }
+        ]);
+
+        if (action === 'accept') {
+          accepted = true;
+        } else if (action === 'edit') {
+          const { newMessage } = await inquirer.prompt([
+            {
+              type: 'input',
+              name: 'newMessage',
+              message: 'Edit commit message:',
+              default: message
+            }
+          ]);
+          message = newMessage;
+          accepted = true;
+        } else if (action === 'cancel') {
+          console.log(chalk.yellow('Commit cancelled.'));
+          process.exit(0);
+        }
+        // If regenerate, loop continues
+      }
+
+      console.log(chalk.blue('Committing...'));
+      commitChanges(message);
+      console.log(chalk.green('Successfully committed!'));
+
+    } catch (error) {
+      console.error(chalk.red(error.message));
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "git-smart-commit-cli",
+  "version": "1.0.0",
+  "description": "AI-powered git commit message generator",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "ai-commit": "index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@google/generative-ai": "^0.21.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "inquirer": "^10.2.2"
+  }
+}