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.
CHECK if gitai is available:
command -v gitai
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."
CHECK if ~/.gitai exists.
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."
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
| Command |
Action Description |
gitai . '' |
Analyzes current folder, Generates message and commits |
gitai . '' --push |
Analyzes current folder, Generates message, commits, AND pushes to remote |
gitai ./frontend 'ui update' |
Analyzes only the ./frontend directory, Generates message and commits |
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
Author
License
MIT
1---2name: gitai-automation3description: Boost developer productivity with Gitai: An AI-powered Git automation tool that analyzes code changes and generates semantic Conventional Commits instantly. Supports Node.js, Python, Java, Go, PHP, and more. Compatible with OpenAI, Anthropic, and Groq.4---5
6# Gitai Automation - AI-Powered Git Workflow
7
8> **Transform your development workflow with intelligent, automated commit management.**
9
10Gitai 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.
11
12**Key capabilities:**
13- **Universal Language Support**: Analyzes Node.js, Python, Java, Go, PHP, and more.
14- **Multi-LLM Support**: Choose your preferred AI brain—OpenAI (GPT), Anthropic (Claude), or Groq.
15- **Workflow Automation**: Stages, commits, and pushes changes in a single command.
16- **Standardized History**: Enforces consistency across your project's version history.
17
18---
19
20## 📦 Prerequisites (MANDATORY)
21
22This skill requires the `@notyped/gitai` CLI tool to be installed and configured on the system **BEFORE** the agent can operate.
23
24**The AGENT MUST NOT attempt to install this package or configure it.**
25
261. **CHECK** if `gitai` is available:
27 ```bash
28 command -v gitai
29 ```
302. **IF MISSING**, STOP immediately and inform the user:
31 > "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."
32
333. **CHECK** if `~/.gitai` exists.
344. **IF MISSING**, STOP immediately and inform the user:
35 > "The `gitai` tool is installed but not configured. Please run `gitai` in your terminal to complete the setup."
36
375. **ONLY PROCEED** if both checks pass.
38
39## 🚀 Usage & Workflows
40
41### Command Structure
42Based on `gitai --help`:
43```bash
44gitai [options] [projectPath] [baseMessage]
45```
46
47**Arguments:**
48- `projectPath`: The path to the project (default: ".").
49- `baseMessage`: The base commit message (Optional).
50
51**Options:**
52- `-p, --push`: Whether to push after committing (default: false).
53- `-V, --version`: Output the version number.
54- `-h, --help`: Display help for command.
55
56### Standard Workflows
57
58| Command | Action Description |
59|---------|--------------------|
60| `gitai . ''` | Analyzes current folder, Generates message and commits |
61| `gitai . '' --push` | Analyzes current folder, Generates message, commits, AND pushes to remote |
62| `gitai ./frontend 'ui update'` | Analyzes only the `./frontend` directory, Generates message and commits |
63
64### Verification
65Check which version of Gitai is currently active:
66```bash
67gitai --version
68```
69
70
71
72---
73
74## ⚠️ Troubleshooting
75
76- **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.
77- **Node Version Error**: Ensure Node.js 18+ is active (`node -v`).
78- **API Errors**: Check the `API_KEY` in `~/.gitai`.
79
80---
81
82## Links
83- **GitHub**: [https://github.com/leandrosilvaferreira/gitai-skill](https://github.com/leandrosilvaferreira/gitai-skill)
84- **Issues**: [https://github.com/leandrosilvaferreira/gitai-skill/issues](https://github.com/leandrosilvaferreira/gitai-skill/issues)
85
86## Author
87- **Leandro Zuck**
88- **GitHub**: [https://github.com/leandrosilvaferreira](https://github.com/leandrosilvaferreira)
89- **Email**: leandrosilvaferreira@gmail.com
90
91## License
92MIT
modbender