Gitai Automation

Gitai Automation - AI-Powered Git Workflow

Transform your development workflow with intelligent, automated commit management.

Gitai analyzes your code changes to generate precise, descriptive commit messages following the Conventional Commits standard. It eliminates the friction of writing commit messages, ensuring a clean, semantic, and professional git history automatically.

Key capabilities:

• Universal Language Support: Analyzes Node.js, Python, Java, Go, PHP, and more.
• Multi-LLM Support: Choose your preferred AI brain—OpenAI (GPT), Anthropic (Claude), or Groq.
• Workflow Automation: Stages, commits, and pushes changes in a single command.
• Standardized History: Enforces consistency across your project's version history.

---

📦 Prerequisites (MANDATORY)

This skill requires the @notyped/gitai CLI tool to be installed and configured on the system BEFORE the agent can operate.

The AGENT MUST NOT attempt to install this package or configure it.

1. CHECK if gitai is available:

    command -v gitai

2. IF MISSING, STOP immediately and inform the user:

"The gitai CLI tool is not installed. Please install it globally (e.g., npm install -g @notyped/gitai) and configure it before using this skill."

3. CHECK if ~/.gitai exists. 4. IF MISSING, STOP immediately and inform the user:

"The gitai tool is installed but not configured. Please run gitai in your terminal to complete the setup."

5. ONLY PROCEED if both checks pass.

🚀 Usage & Workflows

Command Structure

Based on gitai --help:

gitai [options] [projectPath] [baseMessage]

Arguments:

• projectPath: The path to the project (default: ".").
• baseMessage: The base commit message (Optional).

Options:

• -p, --push: Whether to push after committing (default: false).
• -V, --version: Output the version number.
• -h, --help: Display help for command.

Standard Workflows

Verification

Check which version of Gitai is currently active:

gitai --version

---

⚠️ Troubleshooting

• Interactive Wizard Hangs: If gitai hangs waiting for input, it means ~/.gitai is missing or invalid. create the file manually as described in Step 2.
• Node Version Error: Ensure Node.js 18+ is active (node -v).
• API Errors: Check the API_KEY in ~/.gitai.

---

Links

• GitHub: https://github.com/leandrosilvaferreira/gitai-skill
• Issues: https://github.com/leandrosilvaferreira/gitai-skill/issues

Author

• Leandro Zuck
• GitHub: https://github.com/leandrosilvaferreira
• Email: leandrosilvaferreira@gmail.com

License

MIT

Gitai: Automated Conventional Commits

Transform your git history with AI. From chaotic logs to semantic perfection.

    

---

The Problem

Writing meaningful commit messages is often the last thing on a developer's mind. We're focused on the code, not the log. This leads to repositories full of fix, wip, or update messages that make history audits a nightmare.

Common issues:

• Inconsistent History: "Added feature" vs "feat: add new feature"
• Mental Fatigue: Context switching to write summaries breaks flow
• Lost Context: "Fixed bug" (Which bug? How? Why?)
• Time Wasted: Minutes lost per day thinking of message formatting

The Solution

Gitai acts as your intelligent pair programmer that handles the bureaucracy of version control. It analyzes your staged changes and generates precise, descriptive, Conventional Commits-compliant messages instantly.

Result: A professional, navigable git history with zero extra effort.

Efficiency Comparison

Quick Start

Installation

MacOS / Linux:

chmod +x scripts/install.sh
./scripts/install.sh

Windows (PowerShell):

.\scripts\install.ps1

Configuration (One Time)

Gitai needs to know your preferred AI provider. Run the setup:

1. Create ~/.gitai:

    nano ~/.gitai

2. Add your settings:

    PROVIDER=openai # or anthropic, groq
    API_KEY=sk-...
    MODEL=gpt-4o
    LANGUAGE=en

Features

1. Universal Language Support

Gitai understands code, not just syntax. Whether you're writing Node.js, Python, Java, Go, PHP, or Rust, Gitai analyzes the logic changes to generate accurate summaries.

2. Multi-LLM Support

Choose your brain. Gitai supports:

• OpenAI (GPT-4o, GPT-3.5)
• Anthropic (Claude 3.5 Sonnet, Haiku)
• Groq (Llama 3, Mixtral - strict/fast)

3. Workflow Automation

Combine stages, commits, and pushes into single fluid actions.

Standard Workflow:

# Analyze all changes, commit, and push
gitai . "" --push

Scoped Workflow:

# Analyze only frontend folder
gitai ./frontend "ui refresh"

Usage

Basic Usage

gitai [path] [base-message] [options]

Examples

Troubleshooting

Wizard Hangs?

If gitai hangs waiting for input, ensure your ~/.gitai config file exists and is valid. Background agents cannot interact with the setup wizard.

"Command not found"?

Ensure the installation script completed successfully and added gitai to your PATH.

Support

• Issues: GitHub Issues

If Gitai saves you time, consider supporting development:


License

MIT. See LICENSE for details.

---

Built with ❤️ by [Leandro Zuck](https://github.com/leandrosilvaferreira)