AI-powered Git CLI that writes your commit messages for you

Because life's too short for "fix stuff" commits 🎯

Installation • Quick Start • Commands • AI Setup • Configuration

• 🤖 AI-Generated Commits — Let AI analyze your changes and write meaningful commit messages
• 📊 Smart Status — Enhanced git status with file type detection and insights
• 🔄 Workflow Shortcuts — Common multi-step operations condensed to single commands
• 📈 Commit Analytics — Track your commit streak, patterns, and statistics
• 🔍 Code Review — Get AI-powered code review before committing
• 🛡️ Safe Operations — Built-in safeguards for destructive commands
• ⚡ Lightning Fast — Optimized for speed with intelligent caching

npm install -g gims

Requirements: Node.js >= 18.18.0

# 1. Setup AI provider (choose one)
g setup --api-key gemini    # 🆓 Free & fast (recommended)
g setup --api-key openai    # 🎯 High quality
g setup --api-key groq      # ⚡ Ultra fast

# 2. Start using it!
g s                         # Check status with AI insights
g o                         # AI commit + push (one command!)

# Before (traditional git)
git add .
git commit -m "trying to think of message..."
git push

# After (with GIMS)
g o                         # That's it. AI handles the rest.

GIMS now uses the S4 Versioning System, a forensic-grade versioning standard stored entirely in Git Tags.

MAJOR.MINOR.PATCH-STAGE.BUILD+DATE.TIME.COMMIT.BRANCH (e.g., 0.8.2-dev.1+20250129.1305.af8d9c.main)

Note: S4 uses Git Tags as the Single Source of Truth. No VERSION file is created. It updates your .env version variables if they exist.

GIMS is designed to be "AI-Native", allowing AI agents to directly understand and control your git repository.

GIMS includes a built-in MCP server. This allows AI assistants like Claude Desktop, Cursor, and VS Code to directly "see" and "use" GIMS tools.

• get_status: Get AI-enhanced git status and insights.
• analyze_history: Analyze commit history and patterns.
• version_info: Get current S4 version details.
• generate_commit_message: Generate a commit message for staged changes.
• run_git_command: Safe execution of raw git commands.

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gims": {
      "command": "node",
      "args": ["/path/to/gims/mcp/index.js"]
    }
  }
}

If you are building your own AI agent (using OpenAI, LangChain, etc.), you can plug GIMS tools directly into your tools array using our auto-generated schemas.

Schema Location: bin/tools-schema.json

const tools = require('gims/bin/tools-schema.json');
// Pass 'tools' directly to OpenAI API

GIMS supports multiple AI providers. Choose based on your needs:

g setup --api-key gemini    # Guided setup with instructions
g setup --api-key openai
g setup --api-key groq

GIMS automatically detects API keys from environment variables. Add to your shell profile (~/.zshrc, ~/.bashrc, etc.):

# Gemini (recommended - free)
export GEMINI_API_KEY="your-api-key-here"

# OpenAI
export OPENAI_API_KEY="your-api-key-here"

# Groq
export GROQ_API_KEY="your-api-key-here"

Then reload your shell: source ~/.zshrc

💡 Tip: If multiple API keys are set, GIMS auto-selects in order: Gemini → OpenAI → Groq

# View current settings
g config --list

# Enable conventional commits (feat:, fix:, etc.)
g config --set conventional=true

# Auto-stage all changes before commit
g config --set autoStage=true

# Disable clipboard copy
g config --set copy=false

# Show/hide progress indicators
g config --set progressIndicators=true

g s              # Check what's changed
g sp             # Safe pull (won't lose uncommitted work)
# ... do your work ...
g o              # Commit everything with AI message + push

g r              # Get AI review of your changes
g o              # Commit if review looks good

g fix            # See sync status and options
g fix --ai       # Get AI recommendation
g fix --merge    # Merge remote changes
g fix --rebase   # Rebase onto remote

g ss             # Quick stash
g main           # Switch to main and pull
# ... check something ...
g pop            # Get your work back

g split          # Get suggestions for splitting changes
g sg --multiple  # Get multiple commit message options

g --help         # Full command list with descriptions
g q              # Quick reference card
g <command> -h   # Help for specific command

Contributions are welcome! Feel free to:

• 🐛 Report bugs
• 💡 Suggest features
• 🔧 Submit pull requests

MIT © S41R4J