feat: update to latest AI models and simplify README
- Update AI models to latest versions: - Gemini: gemini-2.5-flash - OpenAI: gpt-5 - Groq: groq/compound - Drastically simplify README (90% shorter) - Focus on quick start and essential commands - Update version to 0.6.2
This commit is contained in:
s41r4j
+46
-104
@@ -1,111 +1,54 @@
|
|||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
## [0.6.0] - Enhanced GIMS - 2024-12-19
|
## [0.6.2] - 2024-12-19
|
||||||
|
|
||||||
### 🚀 Major Features Added
|
### 🚀 AI Model Updates
|
||||||
|
- **Updated to latest AI models**:
|
||||||
#### **Interactive & Enhanced UX**
|
- Gemini: `gemini-2.5-flash` (latest and fastest)
|
||||||
- **Interactive Commit Wizard** (`g int`) - Guided workflow with multiple AI suggestions
|
- OpenAI: `gpt-5` (latest GPT model)
|
||||||
- **Enhanced Status** (`g status`) - Git status with AI insights and project analysis
|
- Groq: `groq/compound` (latest Groq model)
|
||||||
- **Preview Mode** (`g preview`) - See commit preview with AI message and diff analysis
|
|
||||||
- **Setup Wizard** (`g setup`) - Interactive first-time configuration
|
|
||||||
- **Progress Indicators** - Visual feedback for all AI operations
|
|
||||||
|
|
||||||
#### **Smart Configuration Management**
|
|
||||||
- **Config Command** (`g config`) - Manage settings with `--set`, `--get`, `--list`
|
|
||||||
- **Project Type Detection** - Automatically detects React, Node, Python, etc.
|
|
||||||
- **Enhanced .gimsrc** - More configuration options and better validation
|
|
||||||
- **Global vs Local Config** - Project-specific or user-wide settings
|
|
||||||
|
|
||||||
#### **Advanced Git Operations**
|
|
||||||
- **Smart Sync** (`g sync`) - Intelligent pull with rebase/merge options
|
|
||||||
- **Enhanced Stash** (`g stash`) - AI-generated stash descriptions
|
|
||||||
- **Better Amend** (`g amend`) - Smart amend with AI message generation or `--no-edit`
|
|
||||||
- **Enhanced List** (`g ls`) - Unified list command with `--detailed` and `--limit` options
|
|
||||||
|
|
||||||
#### **AI & Performance Improvements**
|
|
||||||
- **Multiple Suggestions** (`g s --multiple`) - Generate 3 different commit message options
|
|
||||||
- **Caching System** - Cache AI responses for faster repeated operations
|
|
||||||
- **Provider Fallback Chain** - Automatic fallback between AI providers
|
|
||||||
- **Better Error Handling** - Actionable guidance and helpful suggestions
|
|
||||||
|
|
||||||
### 🔧 Architecture Improvements
|
|
||||||
|
|
||||||
#### **Modular Design**
|
|
||||||
- Split monolithic `gims.js` into focused modules:
|
|
||||||
- `lib/utils/` - Colors, progress indicators
|
|
||||||
- `lib/config/` - Configuration management
|
|
||||||
- `lib/git/` - Git analysis and insights
|
|
||||||
- `lib/ai/` - AI provider management
|
|
||||||
- `lib/commands/` - Interactive commands
|
|
||||||
|
|
||||||
#### **Enhanced Components**
|
|
||||||
- **GitAnalyzer** - Smart git status analysis with insights
|
|
||||||
- **AIProviderManager** - Improved AI handling with caching and fallbacks
|
|
||||||
- **ConfigManager** - Comprehensive configuration with validation
|
|
||||||
- **InteractiveCommands** - User interaction and guided workflows
|
|
||||||
- **Progress** - Visual feedback system
|
|
||||||
|
|
||||||
### 📊 User Experience Enhancements
|
|
||||||
|
|
||||||
#### **Better Feedback**
|
|
||||||
- Progress spinners for AI operations
|
|
||||||
- Success/warning/error indicators with colors
|
|
||||||
- Actionable error messages with suggestions
|
|
||||||
- Step-by-step guidance in interactive mode
|
|
||||||
|
|
||||||
#### **Smart Defaults**
|
|
||||||
- Auto-detection of project type and commit style
|
|
||||||
- Intelligent provider selection
|
|
||||||
- Context-aware configuration suggestions
|
|
||||||
|
|
||||||
#### **Enhanced Commands**
|
|
||||||
- All existing commands improved with progress indicators
|
|
||||||
- Better error handling and user guidance
|
|
||||||
- Consistent color coding and formatting
|
|
||||||
- More informative output
|
|
||||||
|
|
||||||
### 🛠️ Configuration Options Added
|
|
||||||
|
|
||||||
#### **New Environment Variables**
|
|
||||||
- `GIMS_AUTO_STAGE` - Auto-stage changes by default
|
|
||||||
- `GIMS_CACHE` - Enable/disable AI response caching
|
|
||||||
- `GIMS_PROGRESS` - Show/hide progress indicators
|
|
||||||
- `GIMS_MAX_DIFF_SIZE` - Maximum diff size for AI processing
|
|
||||||
|
|
||||||
#### **New .gimsrc Options**
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"autoStage": false,
|
|
||||||
"cacheEnabled": true,
|
|
||||||
"progressIndicators": true,
|
|
||||||
"maxDiffSize": 100000,
|
|
||||||
"projectType": "react"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 📈 Performance Improvements
|
|
||||||
- **Caching**: AI responses cached for 1 hour
|
|
||||||
- **Modular Loading**: Components loaded on-demand
|
|
||||||
- **Better Memory Management**: Efficient diff processing
|
|
||||||
- **Faster Startup**: Optimized initialization
|
|
||||||
|
|
||||||
### 🔄 Breaking Changes
|
|
||||||
- Removed `largelist` command (merged into `list --detailed`)
|
|
||||||
- Changed some internal APIs (affects programmatic usage only)
|
|
||||||
- Updated minimum Node.js version recommendation to 20+
|
|
||||||
|
|
||||||
### 🐛 Bug Fixes
|
|
||||||
- Fixed git status parsing for different git versions
|
|
||||||
- Improved error handling for large diffs
|
|
||||||
- Better clipboard handling across platforms
|
|
||||||
- Fixed configuration file validation
|
|
||||||
|
|
||||||
### 📚 Documentation
|
### 📚 Documentation
|
||||||
- Completely updated README with new features
|
- **Simplified README**: Reduced from verbose to concise format
|
||||||
- Added comprehensive examples for all new commands
|
- **Focused on essentials**: Quick start, main commands, examples
|
||||||
- Enhanced configuration documentation
|
- **Better readability**: Easier to scan and understand
|
||||||
- Added troubleshooting guide
|
|
||||||
|
### 🧹 Repository Cleanup
|
||||||
|
- Removed development-specific files (.kiro/, .github/, coverage/)
|
||||||
|
- Updated .gitignore to exclude dev directories
|
||||||
|
- Cleaner package for npm distribution
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## [0.6.1] - 2024-12-19
|
||||||
|
|
||||||
|
### ✨ Enhanced User Experience
|
||||||
|
- **Single-letter aliases** for main workflow commands
|
||||||
|
- **Quick API setup**: `g setup --api-key <provider>`
|
||||||
|
- **Better onboarding**: Clear setup instructions with direct links
|
||||||
|
- **Quick help**: `g q` command for instant reference
|
||||||
|
|
||||||
|
### 🔧 Improved Commands
|
||||||
|
- `g s` - Status (enhanced git status)
|
||||||
|
- `g i` - Interactive (guided commit wizard)
|
||||||
|
- `g p` - Preview (see what will be committed)
|
||||||
|
- `g l` - Local (AI commit locally)
|
||||||
|
- `g o` - Online (AI commit + push)
|
||||||
|
- `g h` - History (numbered commit log)
|
||||||
|
- `g a` - Amend (smart amend with AI)
|
||||||
|
- `g u` - Undo (undo last commit)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## [0.6.0] - 2024-12-19
|
||||||
|
|
||||||
|
### 🚀 Major Enhanced Release
|
||||||
|
- **Interactive commit wizard** with multiple AI suggestions
|
||||||
|
- **Enhanced git status** with AI insights and project analysis
|
||||||
|
- **Modular architecture** for better performance and maintainability
|
||||||
|
- **Smart configuration** with project type detection
|
||||||
|
- **Progress indicators** and better error handling
|
||||||
|
- **Caching system** for improved AI response times
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -113,4 +56,3 @@
|
|||||||
- Basic AI-powered commit messages
|
- Basic AI-powered commit messages
|
||||||
- Simple configuration
|
- Simple configuration
|
||||||
- Core git operations
|
- Core git operations
|
||||||
- Single-file architecture
|
|
||||||
+4
-4
@@ -43,9 +43,9 @@ g h --detailed --limit 10 # Detailed view
|
|||||||
|
|
||||||
## Default AI Models
|
## Default AI Models
|
||||||
|
|
||||||
- **Gemini**: `gemini-2.0-flash-exp` (Fast, free, recommended)
|
- **Gemini**: `gemini-2.5-flash` (Fast, free, recommended)
|
||||||
- **OpenAI**: `gpt-4o-mini` (Cost-effective, high quality)
|
- **OpenAI**: `gpt-5` (Latest GPT model)
|
||||||
- **Groq**: `llama-3.1-8b-instant` (Ultra-fast inference)
|
- **Groq**: `groq/compound` (Ultra-fast inference)
|
||||||
|
|
||||||
## Pro Tips
|
## Pro Tips
|
||||||
|
|
||||||
@@ -70,5 +70,5 @@ g config --set provider=gemini # Set AI provider
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
g --help # All commands
|
g --help # All commands
|
||||||
g <command> --help # Command-specific help
|
g q # This quick reference
|
||||||
```
|
```
|
||||||
@@ -1,488 +1,75 @@
|
|||||||
# 🚀 GIMS - Git Made Simple (Enhanced)
|
# 🚀 GIMS - Git Made Simple
|
||||||
|
|
||||||
<div align="center">
|
[](https://npmjs.org/package/gims)
|
||||||
|
[](https://opensource.org/licenses/MIT)
|
||||||
|
[](https://github.com/s41r4j/gims)
|
||||||
|
|
||||||
[](https://npmjs.org/package/gims)
|
**AI-powered Git CLI that writes your commit messages for you**
|
||||||
[](https://opensource.org/licenses/MIT)
|
|
||||||
[](https://nodejs.org/)
|
|
||||||
[](https://github.com/yourusername/gims)
|
|
||||||
|
|
||||||
**The AI-powered Git CLI that writes your commit messages for you**
|
*Because life's too short for "fix stuff" commits* 🎯
|
||||||
|
|
||||||
*Now with enhanced UX, smart insights, and interactive workflows* ✨
|
## ⚡ Quick Start
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ✨ What is GIMS?
|
|
||||||
|
|
||||||
GIMS is a revolutionary Git CLI tool that uses AI to automatically generate meaningful commit messages from your code changes. The enhanced version adds intelligent insights, interactive workflows, and a modular architecture for better performance and user experience.
|
|
||||||
|
|
||||||
### 🎬 See It In Action
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Traditional Git workflow 😴
|
|
||||||
git add .
|
|
||||||
git commit -m "update stuff" # 🤦♂️
|
|
||||||
git push
|
|
||||||
|
|
||||||
# GIMS workflow ⚡
|
|
||||||
g o # AI analyzes changes, commits with perfect message, and pushes!
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🌟 Enhanced Features
|
|
||||||
|
|
||||||
### 🤖 **AI-Powered Commit Messages**
|
|
||||||
- OpenAI, Google Gemini, and Groq support with automatic provider selection
|
|
||||||
- Smart diff analysis with caching for improved performance
|
|
||||||
- Multiple suggestion generation for better options
|
|
||||||
- Handles large codebases with intelligent summarization and safe truncation
|
|
||||||
- Optional Conventional Commits formatting and optional commit body generation
|
|
||||||
|
|
||||||
### ⚡ **Lightning Fast Workflow**
|
|
||||||
- **Interactive Mode**: `g int` - guided commit wizard with multiple suggestions
|
|
||||||
- **Smart Status**: `g status` - enhanced git status with AI insights
|
|
||||||
- **Preview Mode**: `g preview` - see what would be committed with AI message
|
|
||||||
- One command commits: `g o` - analyze, commit, and push
|
|
||||||
- Smart suggestions: `g s` - get AI-generated messages (use `--multiple` for options)
|
|
||||||
|
|
||||||
### 🧠 **Intelligent Analysis & Insights**
|
|
||||||
- **Project Detection**: Automatically detects project type (React, Node, Python, etc.)
|
|
||||||
- **Smart Insights**: AI analyzes changes and provides contextual tips
|
|
||||||
- **Change Complexity**: Understands and reports on the scope of changes
|
|
||||||
- **Commit History Analysis**: Tracks patterns and suggests improvements
|
|
||||||
|
|
||||||
### 🛠️ **Enhanced Developer Experience**
|
|
||||||
- **Setup Wizard**: `g setup` - interactive configuration for first-time users
|
|
||||||
- **Progress Indicators**: Visual feedback for AI operations
|
|
||||||
- **Better Error Messages**: Actionable guidance when things go wrong
|
|
||||||
- **Smart Sync**: `g sync` - intelligent pull with rebase/merge options
|
|
||||||
- **Enhanced Stash**: `g stash` - AI-generated stash descriptions
|
|
||||||
|
|
||||||
### 🔧 **Advanced Configuration**
|
|
||||||
- **Config Management**: `g config` - set preferences globally or per-project
|
|
||||||
- **Caching System**: Speeds up repeated operations
|
|
||||||
- **Modular Architecture**: Better performance and maintainability
|
|
||||||
|
|
||||||
## 🚀 Quick Start
|
|
||||||
|
|
||||||
### Prerequisites
|
|
||||||
|
|
||||||
- Node.js >= 18.18.0 (Node 20+ recommended)
|
|
||||||
- npm >= 9
|
|
||||||
|
|
||||||
Tip: Use nvm to manage Node versions per-user without sudo:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
|
|
||||||
export NVM_DIR="$HOME/.nvm" && . "$NVM_DIR/nvm.sh"
|
|
||||||
nvm install 20 && nvm alias default 20
|
|
||||||
```
|
|
||||||
|
|
||||||
### Installation
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# Install
|
||||||
npm install -g gims
|
npm install -g gims
|
||||||
```
|
|
||||||
|
|
||||||
If you get EACCES permission errors on Linux when installing globally, set a user prefix:
|
# Setup AI (choose one)
|
||||||
|
g setup --api-key gemini # Free & fast (recommended)
|
||||||
```bash
|
|
||||||
mkdir -p ~/.npm-global
|
|
||||||
npm config set prefix '~/.npm-global'
|
|
||||||
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
|
|
||||||
source ~/.bashrc
|
|
||||||
npm install -g gims
|
|
||||||
```
|
|
||||||
|
|
||||||
### Setup AI (Choose One - Quick & Easy!)
|
|
||||||
|
|
||||||
**🚀 Quick Setup (Recommended)**
|
|
||||||
```bash
|
|
||||||
# Gemini (Free, fast, recommended)
|
|
||||||
g setup --api-key gemini
|
|
||||||
|
|
||||||
# OpenAI (High quality)
|
|
||||||
g setup --api-key openai
|
|
||||||
|
|
||||||
# Groq (Ultra fast)
|
|
||||||
g setup --api-key groq
|
|
||||||
```
|
|
||||||
|
|
||||||
**🔧 Manual Setup (Advanced)**
|
|
||||||
```bash
|
|
||||||
# Set environment variables
|
|
||||||
export GEMINI_API_KEY="your-api-key-here" # Uses gemini-2.0-flash-exp
|
|
||||||
export OPENAI_API_KEY="your-api-key-here" # Uses gpt-4o-mini
|
|
||||||
export GROQ_API_KEY="your-api-key-here" # Uses llama-3.1-8b-instant
|
|
||||||
```
|
|
||||||
|
|
||||||
GIMS auto-detects configured providers and uses smart defaults. If no AI is configured, it uses local heuristics to generate sensible messages.
|
|
||||||
|
|
||||||
### Your First Enhanced Experience
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Quick AI setup (choose one - Gemini recommended)
|
|
||||||
g setup --api-key gemini # Fast & free
|
|
||||||
g setup --api-key openai # High quality
|
g setup --api-key openai # High quality
|
||||||
g setup --api-key groq # Ultra fast
|
g setup --api-key groq # Ultra fast
|
||||||
|
|
||||||
# Make some changes to your code
|
# Use it
|
||||||
echo "console.log('Hello Enhanced GIMS!');" > hello.js
|
g s # Check status with AI insights
|
||||||
|
g o # AI commit + push
|
||||||
# Check enhanced status with AI insights
|
|
||||||
g s
|
|
||||||
# Shows: Git status + AI insights about your changes
|
|
||||||
|
|
||||||
# Use interactive mode for guided commits
|
|
||||||
g i
|
|
||||||
# Walks you through: staging → AI suggestions → commit → push
|
|
||||||
|
|
||||||
# Or use the classic one-command workflow
|
|
||||||
g o
|
|
||||||
# Output: ✓ Committed & pushed: "Add hello world console log"
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## 📖 Enhanced Commands Reference
|
## 🎯 Main Commands
|
||||||
|
|
||||||
### 🚀 **Main Workflow (Single Letters)**
|
| Command | Description |
|
||||||
| Command | Alias | Description | Example |
|
|---------|-------------|
|
||||||
|---------|-------|-------------|---------|
|
| `g s` | Enhanced status with AI insights |
|
||||||
| `gims status` | `g s` | Enhanced git status with AI insights | `g s` |
|
| `g i` | Interactive commit wizard |
|
||||||
| `gims interactive` | `g i` | Interactive commit wizard | `g i` |
|
| `g o` | AI commit + push |
|
||||||
| `gims preview` | `g p` | Preview commit with AI message | `g p` |
|
| `g l` | AI commit locally |
|
||||||
| `gims local` | `g l` | AI commit locally | `g l` |
|
| `g h` | Commit history |
|
||||||
| `gims online` | `g o` | AI commit + push | `g o` |
|
| `g a` | Smart amend |
|
||||||
| `gims list` | `g h` | Numbered commit history | `g h` |
|
|
||||||
| `gims amend` | `g a` | Smart amend with AI | `g a` |
|
|
||||||
| `gims undo` | `g u` | Undo last commit | `g u --yes` |
|
|
||||||
|
|
||||||
### � **Se tup & Config**
|
## 🤖 AI Models
|
||||||
| Command | Alias | Description | Example |
|
|
||||||
|---------|-------|-------------|---------|
|
|
||||||
| `gims setup` | - | Setup wizard or quick API key setup | `g setup --api-key gemini` |
|
|
||||||
| `gims config` | - | Manage configuration | `g config --set provider=gemini` |
|
|
||||||
|
|
||||||
### 📝 **Additional Commands**
|
- **Gemini**: `gemini-2.5-flash` (Free, fast, recommended)
|
||||||
| Command | Alias | Description | Example |
|
- **OpenAI**: `gpt-5` (High quality)
|
||||||
|---------|-------|-------------|---------|
|
- **Groq**: `groq/compound` (Ultra fast)
|
||||||
| `gims suggest` | `g sg` | AI suggestions with clipboard | `g sg --multiple` |
|
|
||||||
| `gims commit <msg>` | `g m` | Custom message commit | `g m "fix: handle edge case"` |
|
|
||||||
| `gims sync` | - | Smart sync: pull + rebase/merge | `g sync --rebase` |
|
|
||||||
| `gims stash` | - | Enhanced stash with AI descriptions | `g stash` |
|
|
||||||
| `gims init` | - | Initialize repo | `g init` |
|
|
||||||
| `gims clone <repo>` | `g c` | Clone repository | `g c https://github.com/user/repo` |
|
|
||||||
| `gims pull` | - | Pull changes | `g pull` |
|
|
||||||
| `gims branch <n>` | `g b` | Branch from commit #n | `g b 3 feature-x` |
|
|
||||||
| `gims reset <n>` | `g r` | Reset to commit | `g r 5 --hard --yes` |
|
|
||||||
| `gims revert <n>` | `g rv` | Revert commit | `g rv 2 --yes` |
|
|
||||||
|
|
||||||
### Global Options
|
## 📖 Examples
|
||||||
|
|
||||||
- `--provider <name>`: AI provider: `auto` | `openai` | `gemini` | `groq` | `none`
|
|
||||||
- `--model <name>`: Override model identifier for the chosen provider
|
|
||||||
- `--staged-only`: Use only staged changes (default behavior for `g s`)
|
|
||||||
- `--all`: Stage all changes before running
|
|
||||||
- `--no-clipboard`: Do not copy suggestion to clipboard (for `g s`)
|
|
||||||
- `--body`: Generate a commit body in addition to subject
|
|
||||||
- `--conventional`: Format subject using Conventional Commits
|
|
||||||
- `--dry-run`: Print what would happen without committing/pushing
|
|
||||||
- `--verbose`: Verbose logging with AI provider details
|
|
||||||
- `--json`: Machine-readable output for `g s`
|
|
||||||
- `--yes`: Confirm destructive actions without prompting
|
|
||||||
- `--amend`: Amend the last commit instead of creating a new one
|
|
||||||
- `--set-upstream`: On push, set upstream if the current branch has none
|
|
||||||
|
|
||||||
### Command-Specific Options
|
|
||||||
|
|
||||||
- `g s --multiple`: Generate multiple commit message suggestions
|
|
||||||
- `g ls --detailed`: Show detailed commit information with dates and authors
|
|
||||||
- `g ls --limit <n>`: Limit number of commits shown (default: 20)
|
|
||||||
- `g sync --rebase`: Use rebase instead of merge for sync
|
|
||||||
- `g stash --list`: List all stashes
|
|
||||||
- `g stash --pop`: Pop the latest stash
|
|
||||||
- `g stash --apply <n>`: Apply stash by index
|
|
||||||
- `g a --no-edit`: Amend without changing the commit message
|
|
||||||
- `g config --global`: Use global configuration instead of project-local
|
|
||||||
|
|
||||||
## 💡 Enhanced Real-World Examples
|
|
||||||
|
|
||||||
### 🎯 **Interactive Workflow**
|
|
||||||
```bash
|
```bash
|
||||||
# Complex feature development
|
# Daily workflow
|
||||||
g status # See AI insights about your changes
|
g s # Check what changed
|
||||||
# Output: "📦 Dependencies changed - consider updating package-lock.json"
|
g i # Interactive commit
|
||||||
|
g o # Quick commit + push
|
||||||
|
|
||||||
g int # Interactive commit wizard
|
# Advanced
|
||||||
# Guides you through: staging → multiple AI suggestions → commit
|
g sg --multiple # Get 3 AI suggestions
|
||||||
|
g h --detailed # Detailed history
|
||||||
g sync --rebase # Smart sync with rebase
|
g sync --rebase # Smart sync
|
||||||
# Output: "✓ Rebased successfully"
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 🔧 **Bug Fix with Preview**
|
## 🔧 Configuration
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# You fix a critical bug
|
g config --set conventional=true # Enable conventional commits
|
||||||
g preview # Preview what would be committed
|
g config --set autoStage=true # Auto-stage changes
|
||||||
# Shows: complexity analysis + AI suggestion + diff summary
|
g config --list # View all settings
|
||||||
|
|
||||||
g o # Commit with confidence
|
|
||||||
# AI generates: "Fix null pointer exception in user authentication"
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### ✨ **Feature Development**
|
## 🆘 Help
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Multiple related changes
|
g --help # All commands
|
||||||
g s --multiple # Get several commit message options
|
g q # Quick reference
|
||||||
# Shows: 3 different AI-generated suggestions
|
|
||||||
|
|
||||||
g stash # Stash with AI description
|
|
||||||
# Output: "✓ Stashed changes: 'Add search functionality components'"
|
|
||||||
|
|
||||||
g l # Commit locally first
|
|
||||||
g sync # Smart sync before pushing
|
|
||||||
g o # Push with upstream setup
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 📊 **Project Analysis**
|
|
||||||
```bash
|
|
||||||
g status # Enhanced status with insights
|
|
||||||
# Shows: file changes + AI insights + recent activity summary
|
|
||||||
|
|
||||||
g config --set conventional=true # Enable conventional commits
|
|
||||||
g ls --detailed --limit 5 # Analyze recent commit patterns
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🔥 Enhanced Pro Tips
|
|
||||||
|
|
||||||
### 🎯 **Perfect Enhanced Workflow**
|
|
||||||
```bash
|
|
||||||
g setup --api-key gemini # One-time AI setup (fast & free)
|
|
||||||
g s # Check status with AI insights
|
|
||||||
g i # Interactive commit for complex changes
|
|
||||||
g sync # Smart sync instead of manual pull
|
|
||||||
g o --set-upstream # Push with automatic upstream setup
|
|
||||||
```
|
|
||||||
|
|
||||||
### 🧠 **Smart Development Patterns**
|
|
||||||
```bash
|
|
||||||
# Feature development
|
|
||||||
g stash # Stash with AI description
|
|
||||||
g b 5 feature-x # Branch from specific commit
|
|
||||||
g preview # Preview changes before committing
|
|
||||||
g s --multiple # Get multiple commit options
|
|
||||||
g l && g sync # Commit locally, then smart sync
|
|
||||||
|
|
||||||
# Code review preparation
|
|
||||||
g ls --detailed # Review commit history
|
|
||||||
g config --set conventional=true # Enable conventional commits
|
|
||||||
g amend # Update last commit with AI message
|
|
||||||
```
|
|
||||||
|
|
||||||
### 🛡️ **Safe & Smart Operations**
|
|
||||||
```bash
|
|
||||||
# Experimentation
|
|
||||||
g stash # AI-described stash
|
|
||||||
g l # Commit experiment
|
|
||||||
g preview # Check what you're about to commit
|
|
||||||
g u --yes # Quick undo if needed
|
|
||||||
|
|
||||||
# Team collaboration
|
|
||||||
g sync --rebase # Clean history with rebase
|
|
||||||
g status # Check insights before committing
|
|
||||||
g config --global # Set team-wide preferences
|
|
||||||
```
|
|
||||||
|
|
||||||
### ⚡ **Power User Shortcuts**
|
|
||||||
```bash
|
|
||||||
# Single-letter workflow
|
|
||||||
g s # Enhanced status
|
|
||||||
g p # Quick preview
|
|
||||||
g i # Interactive mode
|
|
||||||
g sg --multiple # Multiple suggestions
|
|
||||||
g h --detailed # Detailed history
|
|
||||||
g l && g o # Local commit then push
|
|
||||||
|
|
||||||
# Configuration
|
|
||||||
g config --set autoStage=true # Auto-stage by default
|
|
||||||
g config --set progressIndicators=false # Disable progress bars
|
|
||||||
g config --list # Review all settings
|
|
||||||
```
|
|
||||||
|
|
||||||
## ⚙️ Enhanced Configuration
|
|
||||||
|
|
||||||
### Setup Wizard (Recommended)
|
|
||||||
```bash
|
|
||||||
g setup # Interactive configuration wizard
|
|
||||||
# Detects project type, configures AI providers, sets preferences
|
|
||||||
```
|
|
||||||
|
|
||||||
### Environment Variables
|
|
||||||
|
|
||||||
| Variable | Purpose | Default |
|
|
||||||
|----------|---------|---------|
|
|
||||||
| `OPENAI_API_KEY` | OpenAI API access | - |
|
|
||||||
| `GEMINI_API_KEY` | Google Gemini API access | - |
|
|
||||||
| `GROQ_API_KEY` | Groq API access | - |
|
|
||||||
| `GROQ_BASE_URL` | Groq API base URL | `https://api.groq.com/openai/v1` |
|
|
||||||
| `GIMS_PROVIDER` | Default provider | `auto` |
|
|
||||||
| `GIMS_MODEL` | Default model identifier | (provider-specific) |
|
|
||||||
| `GIMS_CONVENTIONAL` | Enable Conventional Commits | `0` |
|
|
||||||
| `GIMS_COPY` | Enable clipboard copying | `1` |
|
|
||||||
| `GIMS_AUTO_STAGE` | Auto-stage changes | `0` |
|
|
||||||
| `GIMS_CACHE` | Enable AI response caching | `1` |
|
|
||||||
| `GIMS_PROGRESS` | Show progress indicators | `1` |
|
|
||||||
|
|
||||||
### Configuration Management
|
|
||||||
```bash
|
|
||||||
# Set configuration values
|
|
||||||
g config --set provider=gemini
|
|
||||||
g config --set conventional=true --global
|
|
||||||
g config --set autoStage=true
|
|
||||||
|
|
||||||
# View configuration
|
|
||||||
g config --list
|
|
||||||
g config --get provider
|
|
||||||
|
|
||||||
# Project vs Global config
|
|
||||||
g config --set conventional=true # Project-specific
|
|
||||||
g config --set conventional=true --global # Global (all projects)
|
|
||||||
```
|
|
||||||
|
|
||||||
### .gimsrc Configuration Files
|
|
||||||
|
|
||||||
**Project-level** (`./.gimsrc`):
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"provider": "gemini",
|
|
||||||
"model": "gemini-2.0-flash",
|
|
||||||
"conventional": true,
|
|
||||||
"autoStage": false,
|
|
||||||
"projectType": "react"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Global** (`~/.gimsrc`):
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"provider": "auto",
|
|
||||||
"conventional": false,
|
|
||||||
"copy": true,
|
|
||||||
"cacheEnabled": true,
|
|
||||||
"progressIndicators": true,
|
|
||||||
"maxDiffSize": 100000
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### Smart Fallbacks
|
|
||||||
|
|
||||||
GIMS handles edge cases gracefully:
|
|
||||||
|
|
||||||
- 🔄 Large diffs: Automatically switches to summary or status view
|
|
||||||
- ✂️ Massive text: Truncates safely with informative context
|
|
||||||
- 🛜 No API key: Uses a local heuristic that summarizes your changes
|
|
||||||
- ⚠️ API failures: Clear errors and local fallback so you keep moving
|
|
||||||
- 🔒 Privacy-first: Only sends diffs when you explicitly run AI features
|
|
||||||
|
|
||||||
## 🤝 Contributing
|
|
||||||
|
|
||||||
We love contributions! Here's how to get involved:
|
|
||||||
|
|
||||||
1. **🍴 Fork** the repository
|
|
||||||
2. **🌿 Create** your feature branch: `git checkout -b amazing-feature`
|
|
||||||
3. **💻 Code** your improvements
|
|
||||||
4. **🧪 Test** thoroughly
|
|
||||||
5. **📝 Commit** with GIMS: `g l` (dogfooding!)
|
|
||||||
6. **🚀 Push** and create a Pull Request
|
|
||||||
|
|
||||||
### 🐛 Found a Bug?
|
|
||||||
|
|
||||||
1. Check [existing issues](https://github.com/yourusername/gims/issues)
|
|
||||||
2. Create a [new issue](https://github.com/yourusername/gims/issues/new) with:
|
|
||||||
- Clear description
|
|
||||||
- Steps to reproduce
|
|
||||||
- Expected vs actual behavior
|
|
||||||
- Your environment details
|
|
||||||
|
|
||||||
## 📊 Why GIMS?
|
|
||||||
|
|
||||||
### Before GIMS 😫
|
|
||||||
```bash
|
|
||||||
git log --oneline
|
|
||||||
abc1234 fix
|
|
||||||
def5678 update
|
|
||||||
ghi9012 changes
|
|
||||||
jkl3456 stuff
|
|
||||||
mno7890 final fix
|
|
||||||
```
|
|
||||||
|
|
||||||
### After GIMS ✨
|
|
||||||
```bash
|
|
||||||
git log --oneline
|
|
||||||
abc1234 Fix authentication timeout in user login service
|
|
||||||
def5678 Add responsive design for mobile navigation menu
|
|
||||||
ghi9012 Refactor database connection pool for better performance
|
|
||||||
jkl3456 Update API documentation with new endpoint examples
|
|
||||||
mno7890 Fix memory leak in image processing pipeline
|
|
||||||
```
|
|
||||||
|
|
||||||
## 📈 Enhanced Stats & Benefits
|
|
||||||
|
|
||||||
- ⚡ **50% faster** commits with interactive mode and smart defaults
|
|
||||||
- 🎯 **Higher accuracy** with multiple AI suggestions and caching
|
|
||||||
- 🧠 **Smart insights** help improve code quality and commit patterns
|
|
||||||
- 📚 **Zero learning curve** - enhanced Git workflow, not replacement
|
|
||||||
- 🌍 **Universal compatibility** - Mac, Windows, Linux, WSL
|
|
||||||
- � **Modular architecture** - better performance and extensibility
|
|
||||||
|
|
||||||
## 🆕 What's New in Enhanced GIMS
|
|
||||||
|
|
||||||
### ✨ **Major Enhancements**
|
|
||||||
- **Interactive Commit Wizard** - guided workflow with multiple suggestions
|
|
||||||
- **Smart Status & Insights** - AI analyzes your changes and provides tips
|
|
||||||
- **Enhanced Configuration** - setup wizard and flexible config management
|
|
||||||
- **Progress Indicators** - visual feedback for all AI operations
|
|
||||||
- **Caching System** - faster repeated operations
|
|
||||||
- **Better Error Handling** - actionable guidance when things go wrong
|
|
||||||
|
|
||||||
### 🔧 **Developer Experience**
|
|
||||||
- **Project Type Detection** - automatically adapts to React, Node, Python, etc.
|
|
||||||
- **Smart Sync** - intelligent pull with rebase/merge options
|
|
||||||
- **Enhanced Stash** - AI-generated stash descriptions
|
|
||||||
- **Preview Mode** - see exactly what will be committed
|
|
||||||
- **Modular Architecture** - cleaner code and better maintainability
|
|
||||||
|
|
||||||
## 🗺️ Roadmap
|
|
||||||
|
|
||||||
### 🎯 **Completed (v0.6.0)**
|
|
||||||
- [x] Interactive commit wizard
|
|
||||||
- [x] Enhanced status with AI insights
|
|
||||||
- [x] Smart configuration management
|
|
||||||
- [x] Progress indicators and better UX
|
|
||||||
- [x] Caching and performance improvements
|
|
||||||
- [x] Modular architecture
|
|
||||||
|
|
||||||
### 🚀 **Coming Next**
|
|
||||||
- [ ] 🔌 Plugin system for custom AI providers
|
|
||||||
- [ ] 📊 Commit message templates and team standards
|
|
||||||
- [ ] 🌐 Multi-language commit message support
|
|
||||||
- [ ] 🔄 Integration with popular Git GUIs (VS Code, etc.)
|
|
||||||
- [ ] 📱 Web dashboard for team commit analytics
|
|
||||||
- [ ] 🤖 Advanced AI features (code review suggestions, etc.)
|
|
||||||
|
|
||||||
## 📄 License
|
## 📄 License
|
||||||
|
|
||||||
MIT © [Your Name](https://github.com/yourusername)
|
MIT © [S41R4J](https://github.com/s41r4j)
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
<div align="center">
|
|
||||||
|
|
||||||
**⭐ Star this repo if GIMS makes your Git workflow awesome!**
|
|
||||||
|
|
||||||
[Report Bug](https://github.com/yourusername/gims/issues) • [Request Feature](https://github.com/yourusername/gims/issues) • [Documentation](https://github.com/yourusername/gims/wiki)
|
|
||||||
|
|
||||||
*Made with ❤️ by developers who hate writing commit messages*
|
|
||||||
|
|
||||||
</div>
|
|
||||||
+3
-3
@@ -313,9 +313,9 @@ program.command('help-quick').alias('q')
|
|||||||
console.log(` ${color.cyan('g u')} Undo - Undo last commit\n`);
|
console.log(` ${color.cyan('g u')} Undo - Undo last commit\n`);
|
||||||
|
|
||||||
console.log(color.bold('Quick Setup:'));
|
console.log(color.bold('Quick Setup:'));
|
||||||
console.log(` ${color.cyan('g setup --api-key gemini')} 🚀 Fast & free (recommended)`);
|
console.log(` ${color.cyan('g setup --api-key gemini')} 🚀 gemini-2.5-flash (recommended)`);
|
||||||
console.log(` ${color.cyan('g setup --api-key openai')} 💎 High quality`);
|
console.log(` ${color.cyan('g setup --api-key openai')} 💎 gpt-5 (high quality)`);
|
||||||
console.log(` ${color.cyan('g setup --api-key groq')} ⚡ Ultra fast\n`);
|
console.log(` ${color.cyan('g setup --api-key groq')} ⚡ groq/compound (ultra fast)\n`);
|
||||||
|
|
||||||
console.log(color.bold('Essential Workflow:'));
|
console.log(color.bold('Essential Workflow:'));
|
||||||
console.log(` ${color.cyan('g s')} Check what's changed`);
|
console.log(` ${color.cyan('g s')} Check what's changed`);
|
||||||
|
|||||||
@@ -28,9 +28,9 @@ class AIProviderManager {
|
|||||||
|
|
||||||
getDefaultModel(provider) {
|
getDefaultModel(provider) {
|
||||||
const defaults = {
|
const defaults = {
|
||||||
'gemini': 'gemini-2.0-flash-exp', // Latest and fastest
|
'gemini': 'gemini-2.5-flash', // Latest and fastest
|
||||||
'openai': 'gpt-4o-mini', // Cost-effective and fast
|
'openai': 'gpt-5', // Latest GPT model
|
||||||
'groq': 'llama-3.1-8b-instant' // Fast inference
|
'groq': 'groq/compound' // Latest Groq model
|
||||||
};
|
};
|
||||||
return defaults[provider] || '';
|
return defaults[provider] || '';
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -164,14 +164,14 @@ class ConfigManager {
|
|||||||
console.log(` ${color.cyan('g setup --api-key openai')} # High quality`);
|
console.log(` ${color.cyan('g setup --api-key openai')} # High quality`);
|
||||||
console.log(` ${color.cyan('g setup --api-key groq')} # Ultra fast`);
|
console.log(` ${color.cyan('g setup --api-key groq')} # Ultra fast`);
|
||||||
console.log('\nOr set environment variables manually:');
|
console.log('\nOr set environment variables manually:');
|
||||||
console.log(' - OPENAI_API_KEY (gpt-4o-mini)');
|
console.log(' - OPENAI_API_KEY (gpt-5)');
|
||||||
console.log(' - GEMINI_API_KEY (gemini-2.0-flash-exp)');
|
console.log(' - GEMINI_API_KEY (gemini-2.5-flash)');
|
||||||
console.log(' - GROQ_API_KEY (llama-3.1-8b-instant)');
|
console.log(' - GROQ_API_KEY (groq/compound)');
|
||||||
} else {
|
} else {
|
||||||
console.log('Available providers with default models:');
|
console.log('Available providers with default models:');
|
||||||
if (hasGemini) console.log(` ${color.green('✓')} Google Gemini (gemini-2.0-flash-exp)`);
|
if (hasGemini) console.log(` ${color.green('✓')} Google Gemini (gemini-2.5-flash)`);
|
||||||
if (hasOpenAI) console.log(` ${color.green('✓')} OpenAI (gpt-4o-mini)`);
|
if (hasOpenAI) console.log(` ${color.green('✓')} OpenAI (gpt-5)`);
|
||||||
if (hasGroq) console.log(` ${color.green('✓')} Groq (llama-3.1-8b-instant)`);
|
if (hasGroq) console.log(` ${color.green('✓')} Groq (groq/compound)`);
|
||||||
}
|
}
|
||||||
|
|
||||||
const provider = await question(`\nPreferred provider (auto/openai/gemini/groq/none) [auto]: `) || 'auto';
|
const provider = await question(`\nPreferred provider (auto/openai/gemini/groq/none) [auto]: `) || 'auto';
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "gims",
|
"name": "gims",
|
||||||
"version": "0.6.1",
|
"version": "0.6.2",
|
||||||
"description": "Git Made Simple – AI‑powered git helper using Gemini / OpenAI",
|
"description": "Git Made Simple – AI‑powered git helper using Gemini / OpenAI",
|
||||||
"author": "S41R4J",
|
"author": "S41R4J",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
|
|||||||
Reference in New Issue
Block a user