🤖 GitAI - AI-Powered Git Assistant

Supercharge your Git workflow with AI! GitAI helps developers write better commit messages, automate branch creation, and maintain consistent Git practices.

---

🎥 Demo

---

✨ Features

• AI-Generated Commit Messages: Automatically generate meaningful commit messages from staged changes
• Commit Message Checking: Fix spelling/grammar mistakes in your commit messages
• Smart Branch Creation: Create branches from GitHub issue URLs automatically
• Git Command Passthrough: All standard Git commands work normally
• Multi-Model Support: Choose between GPT-3.5, GPT-4, or Gemini AI models

---

📦 Installation

Global Installation (Recommended)

npm install -g gitcliai

Using npx (No Installation)

npx gitcliai <command>

Via cURL (Mac/Linux)

curl -sSL https://raw.githubusercontent.com/JASIM0021/gitai/refs/heads/master/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/JASIM0021/gitai/refs/heads/master/install.ps1 | iex

---

🚀 Usage

Fix staged changes with AI-generated message

gitai commit --fix-commit

Check and improve a commit message

gitai commit --spell-check "fix login bugg"

Create branch from GitHub issue

gitai checkout -b --issue https://github.com/user/repo/issues/123

Regular Git commands

gitai status
gitai push
gitai log --oneline

---

🛠 Commands

Command	Description
commit --fix-commit (-fc)	Generate commit message from staged changes
commit --spell-check (-sc)	Improve an existing commit message
checkout -b --issue (-i)	Create branch from GitHub issue URL
[any git command]	Pass through to standard Git

---

⚙️ Configuration

First run will prompt for:

• AI Model Selection (GPT-3.5, GPT-4, or Gemini)
• API Key for your chosen provider

Credentials are stored securely in:

• ~/.gitai_config (model preference)
• ~/.gitai_key (API key with restricted permissions)

---

🧑‍💻 For Contributors

We welcome contributions! Here's how to get started:

Development Setup

Clone the repo:

git clone https://github.com/JASIM0021/gitai
cd gitai

Install dependencies:

npm install

Link for local development:

npm link

Project Structure

src/
├── main.js          # CLI entry point
├── ai/              # AI integration logic
├── config/          # Configuration handling

Testing

npm test

Publishing Changes

Update version in package.json

Run:

npm publish

---

📜 License

MIT License © SK Jasimuddin

---

🙏 Acknowledgements

Inspired by:

• Conventional Commits
• GitLens
• Vs Code
• Cursor

---

📬 Feedback

Found a bug? Have a feature request?
Open an issue or submit a PR!

⭐ Star the repo if you find this useful!