gims 0.6.1 → 0.6.3

package/CHANGELOG.md

@@ -1,116 +1,58 @@
 # 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**:
+  - Gemini: `gemini-2.5-flash` (latest and fastest)
+  - OpenAI: `gpt-5` (latest GPT model)
+  - Groq: `groq/compound` (latest Groq model)
 
-#### **Interactive & Enhanced UX**
-- **Interactive Commit Wizard** (`g int`) - Guided workflow with multiple AI suggestions
-- **Enhanced Status** (`g status`) - Git status with AI insights and project analysis
-- **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
+### 📚 Documentation
+- **Simplified README**: Reduced from verbose to concise format
+- **Focused on essentials**: Quick start, main commands, examples
+- **Better readability**: Easier to scan and understand
 
-#### **Enhanced Commands**
-- All existing commands improved with progress indicators
-- Better error handling and user guidance
-- Consistent color coding and formatting
-- More informative output
+### 🧹 Repository Cleanup
+- Removed development-specific files (.kiro/, .github/, coverage/)
+- Updated .gitignore to exclude dev directories
+- Cleaner package for npm distribution
 
-### 🛠️ 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
+## [0.6.1] - 2024-12-19
 
-#### **New .gimsrc Options**
-```json
-{
-  "autoStage": false,
-  "cacheEnabled": true,
-  "progressIndicators": true,
-  "maxDiffSize": 100000,
-  "projectType": "react"
-}
-```
+### ✨ 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
 
-### 📈 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
+### 🔧 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)
 
-### 🔄 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
+## [0.6.0] - 2024-12-19
 
-### 📚 Documentation
-- Completely updated README with new features
-- Added comprehensive examples for all new commands
-- Enhanced configuration documentation
-- Added troubleshooting guide
+### 🚀 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
 
 ---
 
 ## [0.5.4] - Previous Version
 - Basic AI-powered commit messages
 - Simple configuration
-- Core git operations
-- Single-file architecture
+- Core git operations

package/QUICK_REFERENCE.md

@@ -8,7 +8,9 @@ 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 ls   # List - Short commit history
+g ll   # Large List - Detailed commit history  
+g h    # History - Alias for list
 g a    # Amend - Smart amend with AI
 g u    # Undo - Undo last commit
 ```
@@ -37,15 +39,16 @@ g o          # One-command: commit + push
 g l          # Local commit only
 
 # 3. View history
-g h          # Recent commits
-g h --detailed --limit 10  # Detailed view
+g ls         # Recent commits (short)
+g ll         # Recent commits (detailed)
+g h          # Same as g ls
 ```
 
 ## Default AI Models
 
-- **Gemini**: `gemini-2.0-flash-exp` (Fast, free, recommended)
-- **OpenAI**: `gpt-4o-mini` (Cost-effective, high quality)
-- **Groq**: `llama-3.1-8b-instant` (Ultra-fast inference)
+- **Gemini**: `gemini-2.5-flash` (Fast, free, recommended)
+- **OpenAI**: `gpt-5` (Latest GPT model)
+- **Groq**: `groq/compound` (Ultra-fast inference)
 
 ## Pro Tips
 
@@ -70,5 +73,5 @@ g config --set provider=gemini     # Set AI provider
 
 ```bash
 g --help          # All commands
-g <command> --help # Command-specific help
+g q               # This quick reference
 ```

package/README.md

@@ -1,488 +1,77 @@
-# 🚀 GIMS - Git Made Simple (Enhanced)
+# 🚀 GIMS - Git Made Simple
 
-<div align="center">
-  
-  [![npm version](https://img.shields.io/npm/v/gims.svg)](https://npmjs.org/package/gims)
-  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-  [![Node.js Version](https://img.shields.io/node/v/gims.svg)](https://nodejs.org/)
-  [![AI Powered](https://img.shields.io/badge/AI-Powered-blueviolet.svg)](https://github.com/yourusername/gims)
+[![npm version](https://img.shields.io/npm/v/gims.svg)](https://npmjs.org/package/gims)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![AI Powered](https://img.shields.io/badge/AI-Powered-blueviolet.svg)](https://github.com/s41r4j/gims)
 
-  **The AI-powered Git CLI that writes your commit messages for you**
-  
-  *Now with enhanced UX, smart insights, and interactive workflows* ✨
+**AI-powered Git CLI that writes your commit messages for you**
 
-</div>
+*Because life's too short for "fix stuff" commits* 🎯
 
----
-
-## ✨ 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
+## ⚡ Quick Start
 
 ```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
-npm install -g gims
-```
-
-If you get EACCES permission errors on Linux when installing globally, set a user prefix:
-
-```bash
-mkdir -p ~/.npm-global
-npm config set prefix '~/.npm-global'
-echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
-source ~/.bashrc
+# Install
 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  
+# 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
 
-# Make some changes to your code
-echo "console.log('Hello Enhanced GIMS!');" > hello.js
-
-# 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"
+# Use it
+g s    # Check status with AI insights
+g o    # AI commit + push
 ```
 
-## 📖 Enhanced Commands Reference
-
-### 🚀 **Main Workflow (Single Letters)**
-| Command | Alias | Description | Example |
-|---------|-------|-------------|---------|
-| `gims status` | `g s` | Enhanced git status with AI insights | `g s` |
-| `gims interactive` | `g i` | Interactive commit wizard | `g i` |
-| `gims preview` | `g p` | Preview commit with AI message | `g p` |
-| `gims local` | `g l` | AI commit locally | `g l` |
-| `gims online` | `g o` | AI commit + push | `g o` |
-| `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` |
+## 🎯 Main Commands
 
-### � **Se tup & Config**
-| 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` |
+| 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 |
 
-### 📝 **Additional Commands**
-| Command | Alias | Description | Example |
-|---------|-------|-------------|---------|
-| `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` |
+## 🤖 AI Models
 
-### Global Options
+- **Gemini**: `gemini-2.5-flash` (Free, fast, recommended)
+- **OpenAI**: `gpt-5` (High quality)
+- **Groq**: `groq/compound` (Ultra fast)
 
-- `--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
+## 📖 Examples
 
-### 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
-# Complex feature development
-g status                    # See AI insights about your changes
-# Output: "📦 Dependencies changed - consider updating package-lock.json"
-
-g int                       # Interactive commit wizard
-# Guides you through: staging → multiple AI suggestions → commit
-
-g sync --rebase            # Smart sync with rebase
-# Output: "✓ Rebased successfully"
-```
-
-### 🔧 **Bug Fix with Preview**
 ```bash
-# You fix a critical bug
-g preview                   # Preview what would be committed
-# Shows: complexity analysis + AI suggestion + diff summary
+# Daily workflow
+g s              # Check what changed
+g i              # Interactive commit
+g o              # Quick commit + push
 
-g o                        # Commit with confidence
-# AI generates: "Fix null pointer exception in user authentication"
+# Advanced
+g sg --multiple  # Get 3 AI suggestions
+g ll             # Detailed history
+g sync --rebase  # Smart sync
 ```
 
-### ✨ **Feature Development**
-```bash
-# Multiple related changes
-g s --multiple             # Get several commit message options
-# Shows: 3 different AI-generated suggestions
-
-g stash                    # Stash with AI description
-# Output: "✓ Stashed changes: 'Add search functionality components'"
+## 🔧 Configuration
 
-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
+g config --set conventional=true   # Enable conventional commits
+g config --set autoStage=true      # Auto-stage changes
+g config --list                    # View all settings
 ```
 
-## 🔥 Enhanced Pro Tips
+## 🆘 Help
 
-### 🎯 **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
+g --help    # All commands
+g q         # Quick reference
 ```
 
-### 🧠 **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
 
-MIT © [Your Name](https://github.com/yourusername)
-
----
-
-<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>
+MIT © [S41R4J](https://github.com/s41r4j)

package/bin/gims.js

@@ -308,19 +308,21 @@ program.command('help-quick').alias('q')
     console.log(`  ${color.cyan('g p')}    Preview - See what will be committed`);
     console.log(`  ${color.cyan('g l')}    Local - AI commit locally`);
     console.log(`  ${color.cyan('g o')}    Online - AI commit + push`);
-    console.log(`  ${color.cyan('g h')}    History - Numbered commit log`);
+    console.log(`  ${color.cyan('g ls')}   List - Short commit history`);
+    console.log(`  ${color.cyan('g ll')}   Large List - Detailed commit history`);
+    console.log(`  ${color.cyan('g h')}    History - Alias for list`);
     console.log(`  ${color.cyan('g a')}    Amend - Smart amend with AI`);
     console.log(`  ${color.cyan('g u')}    Undo - Undo last commit\n`);
     
     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 openai')}    💎 High quality`);
-    console.log(`  ${color.cyan('g setup --api-key groq')}      ⚡ Ultra fast\n`);
+    console.log(`  ${color.cyan('g setup --api-key gemini')}    🚀 gemini-2.5-flash (recommended)`);
+    console.log(`  ${color.cyan('g setup --api-key openai')}    💎 gpt-5 (high quality)`);
+    console.log(`  ${color.cyan('g setup --api-key groq')}      ⚡ groq/compound (ultra fast)\n`);
     
     console.log(color.bold('Essential Workflow:'));
     console.log(`  ${color.cyan('g s')}              Check what's changed`);
     console.log(`  ${color.cyan('g i')} or ${color.cyan('g o')}        Commit with AI`);
-    console.log(`  ${color.cyan('g h')}              View history\n`);
+    console.log(`  ${color.cyan('g ls')} or ${color.cyan('g h')}      View history\n`);
     
     console.log(`For full help: ${color.cyan('g --help')}`);
     console.log(`For detailed docs: See README.md`);
@@ -736,9 +738,8 @@ program.command('amend').alias('a')
     }
   });
 
-program.command('list').alias('h')
-  .description('Numbered git log (oldest → newest)')
-  .option('--detailed', 'Show detailed information')
+program.command('list').alias('ls')
+  .description('Short numbered git log (oldest → newest)')
   .option('--limit <n>', 'Limit number of commits', '20')
   .action(async (cmdOptions) => {
     await ensureRepo();
@@ -753,12 +754,7 @@ program.command('list').alias('h')
       }
       
       commits.forEach((c, i) => {
-        if (cmdOptions.detailed) {
-          const date = new Date(c.date).toLocaleString();
-          console.log(`${color.cyan((i+1).toString())}. ${color.yellow(c.hash.slice(0,7))} | ${color.dim(date)} | ${color.green(c.author_name)} → ${c.message}`);
-        } else {
-          console.log(`${color.cyan((i+1).toString())}. ${color.yellow(c.hash.slice(0,7))} ${c.message}`);
-        }
+        console.log(`${color.cyan((i+1).toString())}. ${color.yellow(c.hash.slice(0,7))} ${c.message}`);
       });
       
       if (log.all.length >= limit) {
@@ -769,6 +765,61 @@ program.command('list').alias('h')
     }
   });
 
+program.command('largelist').alias('ll')
+  .description('Detailed numbered git log (oldest → newest)')
+  .option('--limit <n>', 'Limit number of commits', '20')
+  .action(async (cmdOptions) => {
+    await ensureRepo();
+    try {
+      const limit = parseInt(cmdOptions.limit) || 20;
+      const log = await git.log({ maxCount: limit });
+      const commits = [...log.all].reverse();
+      
+      if (commits.length === 0) {
+        Progress.info('No commits found');
+        return;
+      }
+      
+      commits.forEach((c, i) => {
+        const date = new Date(c.date).toLocaleString();
+        console.log(`${color.cyan((i+1).toString())}. ${color.yellow(c.hash.slice(0,7))} | ${color.dim(date)} | ${color.green(c.author_name)} → ${c.message}`);
+      });
+      
+      if (log.all.length >= limit) {
+        console.log(color.dim(`\n... showing last ${limit} commits (use --limit to see more)`));
+      }
+    } catch (e) { 
+      handleError('Largelist error', e); 
+    }
+  });
+
+program.command('history').alias('h')
+  .description('Numbered git log (alias for list)')
+  .option('--limit <n>', 'Limit number of commits', '20')
+  .action(async (cmdOptions) => {
+    await ensureRepo();
+    try {
+      const limit = parseInt(cmdOptions.limit) || 20;
+      const log = await git.log({ maxCount: limit });
+      const commits = [...log.all].reverse();
+      
+      if (commits.length === 0) {
+        Progress.info('No commits found');
+        return;
+      }
+      
+      commits.forEach((c, i) => {
+        console.log(`${color.cyan((i+1).toString())}. ${color.yellow(c.hash.slice(0,7))} ${c.message}`);
+      });
+      
+      if (log.all.length >= limit) {
+        console.log(color.dim(`\n... showing last ${limit} commits (use --limit to see more)`));
+      }
+    } catch (e) { 
+      handleError('History error', e); 
+    }
+  });
+
 program.command('branch <c> [name]').alias('b')
   .description('Branch from commit/index')
   .action(async (c, name) => {

package/bin/lib/ai/providers.js

@@ -28,9 +28,9 @@ class AIProviderManager {
 
   getDefaultModel(provider) {
     const defaults = {
-      'gemini': 'gemini-2.0-flash-exp',  // Latest and fastest
-      'openai': 'gpt-4o-mini',           // Cost-effective and fast
-      'groq': 'llama-3.1-8b-instant'    // Fast inference
+      'gemini': 'gemini-2.5-flash',     // Latest and fastest
+      'openai': 'gpt-5',                // Latest GPT model
+      'groq': 'groq/compound'           // Latest Groq model
     };
     return defaults[provider] || '';
   }

package/bin/lib/config/manager.js

@@ -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 groq')}     # Ultra fast`);
       console.log('\nOr set environment variables manually:');
-      console.log('  - OPENAI_API_KEY (gpt-4o-mini)');
-      console.log('  - GEMINI_API_KEY (gemini-2.0-flash-exp)');
-      console.log('  - GROQ_API_KEY (llama-3.1-8b-instant)');
+      console.log('  - OPENAI_API_KEY (gpt-5)');
+      console.log('  - GEMINI_API_KEY (gemini-2.5-flash)');
+      console.log('  - GROQ_API_KEY (groq/compound)');
     } else {
       console.log('Available providers with default models:');
-      if (hasGemini) console.log(`  ${color.green('✓')} Google Gemini (gemini-2.0-flash-exp)`);
-      if (hasOpenAI) console.log(`  ${color.green('✓')} OpenAI (gpt-4o-mini)`);
-      if (hasGroq) console.log(`  ${color.green('✓')} Groq (llama-3.1-8b-instant)`);
+      if (hasGemini) console.log(`  ${color.green('✓')} Google Gemini (gemini-2.5-flash)`);
+      if (hasOpenAI) console.log(`  ${color.green('✓')} OpenAI (gpt-5)`);
+      if (hasGroq) console.log(`  ${color.green('✓')} Groq (groq/compound)`);
     }
 
     const provider = await question(`\nPreferred provider (auto/openai/gemini/groq/none) [auto]: `) || 'auto';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gims",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Git Made Simple – AI‑powered git helper using Gemini / OpenAI",
   "author": "S41R4J",
   "license": "MIT",

package/.gimsrc

@@ -1,10 +0,0 @@
-{
-  "provider": "gemini",
-  "model": "",
-  "conventional": true,
-  "copy": true,
-  "autoStage": false,
-  "maxDiffSize": 100000,
-  "cacheEnabled": true,
-  "progressIndicators": true
-}

package/.github/workflows/release.yml

@@ -1,25 +0,0 @@
-name: release to npm
-
-on:
-  push:
-    branches: [main]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run tests
-        run: npm test

package/.kiro/steering/product.md

@@ -1,21 +0,0 @@
-# GIMS - Git Made Simple
-
-GIMS is an AI-powered Git CLI tool that automatically generates meaningful commit messages from code changes. It's designed to replace generic commit messages with descriptive, professional ones that tell a story.
-
-## Core Value Proposition
-- Eliminates the need to write commit messages manually
-- Uses AI (OpenAI, Google Gemini, Groq) to analyze code diffs and generate contextual messages
-- Provides a streamlined Git workflow with single-command operations
-- Supports both local and remote operations with intelligent fallbacks
-
-## Key Features
-- AI-powered commit message generation from code diffs
-- One-command workflow: analyze, commit, and push (`g o`)
-- Smart suggestions with clipboard integration (`g s`)
-- Conventional Commits support
-- Numbered commit history and branch management
-- Safe operations with confirmations and dry-run support
-- Graceful fallbacks for large diffs and offline use
-
-## Target Users
-Developers who want to maintain clean Git history without spending time crafting commit messages, especially those working on projects where commit message quality matters for collaboration and code review.

package/.kiro/steering/structure.md

@@ -1,72 +0,0 @@
-# Project Structure
-
-## Directory Layout
-```
-gims/
-├── bin/
-│   └── gims.js              # Main CLI executable and entry point
-├── node_modules/            # npm dependencies (auto-generated)
-├── .npm-cache/             # npm cache directory (auto-generated)
-├── .github/                # GitHub workflows and templates
-├── .git/                   # Git repository data
-├── .kiro/                  # Kiro AI assistant configuration
-│   └── steering/           # AI guidance documents
-├── package.json            # Project metadata and dependencies
-├── package-lock.json       # Dependency lock file
-├── README.md              # Comprehensive project documentation
-├── LICENSE                # MIT license
-└── .gitignore             # Git ignore patterns
-```
-
-## Key Files
-
-### `bin/gims.js`
-- **Purpose**: Single-file CLI application containing all functionality
-- **Structure**: Monolithic approach with utility functions, command handlers, and AI integration
-- **Exports**: Executable binary via shebang (`#!/usr/bin/env node`)
-- **Commands**: All CLI commands and subcommands defined in this file
-
-### `package.json`
-- **Binary entries**: `gims` and `g` both point to `bin/gims.js`
-- **Main entry**: Points to `bin/gims.js`
-- **Scripts**: Minimal test script placeholder
-- **Keywords**: Focused on git, cli, ai, commit, developer-tools
-
-### Configuration Files
-- **`.gimsrc`**: Optional JSON config (project root or home directory)
-- **Environment variables**: API keys and default settings
-- **Git integration**: Uses existing `.git` directory and configuration
-
-## Architecture Principles
-
-### Single-File Design
-- All functionality consolidated in `bin/gims.js` for simplicity
-- No separate modules or complex directory structure
-- Easy to understand, debug, and maintain
-- Reduces complexity for a CLI tool
-
-### Command Structure
-- Uses commander.js for CLI parsing and command organization
-- Short aliases for all commands (`g o`, `g s`, `g l`, etc.)
-- Consistent option patterns across commands
-- Global options available to all subcommands
-
-### File Naming Conventions
-- Executable files in `bin/` directory
-- Configuration files use dotfile convention (`.gimsrc`)
-- Standard npm project files (package.json, README.md, LICENSE)
-- No custom file extensions or special naming schemes
-
-## Development Guidelines
-
-### Adding New Features
-- Add new commands directly to `bin/gims.js`
-- Follow existing pattern of command definition with commander.js
-- Maintain consistent error handling and logging patterns
-- Add appropriate help text and examples
-
-### Configuration Management
-- Environment variables for sensitive data (API keys)
-- JSON config files for user preferences
-- Runtime detection and fallback logic
-- Validate configuration at startup when needed

package/.kiro/steering/tech.md

@@ -1,68 +0,0 @@
-# Technology Stack
-
-## Runtime & Language
-- **Node.js**: >= 18.18.0 (Node 20+ recommended)
-- **JavaScript**: CommonJS modules (`"type": "commonjs"`)
-- **Package Manager**: npm (with package-lock.json)
-
-## Core Dependencies
-- **commander**: CLI framework for command parsing and structure
-- **simple-git**: Git operations and repository management
-- **clipboardy**: Cross-platform clipboard operations
-- **@google/genai**: Google Gemini AI integration
-- **openai**: OpenAI API client
-
-## Architecture Patterns
-- Single-file CLI application (`bin/gims.js`)
-- Functional programming approach with utility functions
-- Configuration via environment variables and `.gimsrc` JSON files
-- Graceful fallbacks and error handling throughout
-- ANSI color utilities without external dependencies
-
-## Code Style Conventions
-- Use `const` for immutable values, avoid `var`
-- Prefer template literals for string interpolation
-- Use async/await for asynchronous operations
-- Implement comprehensive error handling with try/catch
-- Keep functions focused and modular
-- Use descriptive variable names (e.g., `rawDiff`, `prefProvider`)
-- Comment complex logic and AI prompt engineering sections
-
-## Common Commands
-
-### Development
-```bash
-# Install dependencies
-npm install
-
-# Test installation
-npm test  # Currently returns "No tests yet"
-
-# Global installation for testing
-npm install -g .
-```
-
-### Publishing
-```bash
-# Update version
-npm version patch|minor|major
-
-# Publish to npm
-npm publish
-```
-
-### Local Development Testing
-```bash
-# Link for local testing
-npm link
-
-# Test CLI commands
-gims --help
-g --help
-```
-
-## Configuration Management
-- Environment variables for API keys (`OPENAI_API_KEY`, `GEMINI_API_KEY`, `GROQ_API_KEY`)
-- Optional `.gimsrc` JSON config in project root or home directory
-- Runtime provider detection and fallback logic
-- Support for custom models and base URLs