s41r4j
ce005adf22
- Add back separate g ls (short list) and g ll (detailed list) commands - Keep g h as alias for g ls for backward compatibility - Update documentation and quick help to show all three options - Users now have: g ls, g ll, and g h for commit history - Version bump to 0.6.3
77 lines
1.9 KiB
Markdown
77 lines
1.9 KiB
Markdown
# 🚀 GIMS - Git Made Simple
|
|
|
|
[](https://npmjs.org/package/gims)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://github.com/s41r4j/gims)
|
|
|
|
**AI-powered Git CLI that writes your commit messages for you**
|
|
|
|
*Because life's too short for "fix stuff" commits* 🎯
|
|
|
|
## ⚡ Quick Start
|
|
|
|
```bash
|
|
# Install
|
|
npm install -g gims
|
|
|
|
# Setup AI (choose one)
|
|
g setup --api-key gemini # Free & fast (recommended)
|
|
g setup --api-key openai # High quality
|
|
g setup --api-key groq # Ultra fast
|
|
|
|
# Use it
|
|
g s # Check status with AI insights
|
|
g o # AI commit + push
|
|
```
|
|
|
|
## 🎯 Main Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `g s` | Enhanced status with AI insights |
|
|
| `g i` | Interactive commit wizard |
|
|
| `g o` | AI commit + push |
|
|
| `g l` | AI commit locally |
|
|
| `g ls` | Commit history (short) |
|
|
| `g ll` | Commit history (detailed) |
|
|
| `g h` | Commit history (alias for ls) |
|
|
| `g a` | Smart amend |
|
|
|
|
## 🤖 AI Models
|
|
|
|
- **Gemini**: `gemini-2.5-flash` (Free, fast, recommended)
|
|
- **OpenAI**: `gpt-5` (High quality)
|
|
- **Groq**: `groq/compound` (Ultra fast)
|
|
|
|
## 📖 Examples
|
|
|
|
```bash
|
|
# Daily workflow
|
|
g s # Check what changed
|
|
g i # Interactive commit
|
|
g o # Quick commit + push
|
|
|
|
# Advanced
|
|
g sg --multiple # Get 3 AI suggestions
|
|
g ll # Detailed history
|
|
g sync --rebase # Smart sync
|
|
```
|
|
|
|
## 🔧 Configuration
|
|
|
|
```bash
|
|
g config --set conventional=true # Enable conventional commits
|
|
g config --set autoStage=true # Auto-stage changes
|
|
g config --list # View all settings
|
|
```
|
|
|
|
## 🆘 Help
|
|
|
|
```bash
|
|
g --help # All commands
|
|
g q # Quick reference
|
|
```
|
|
|
|
## 📄 License
|
|
|
|
MIT © [S41R4J](https://github.com/s41r4j) |