🚀 Auto Push - AI Powered Git Automation

Auto Push is a smart VS Code extension that automatically commits and pushes your code changes with AI-generated commit messages. Perfect for developers who want to maintain consistent commit history without manual effort.

📥 Installation

Step 1: Install the Extension

Open VS Code
Go to Extensions panel (Ctrl+Shift+X)
Search for "Auto Push"
Click Install button

Step 2: Activate the Extension

The extension activates automatically after installation
You'll see the 🚀 icon in the left sidebar

🔑 AI Setup (One-Time Required)

To use AI features, you need to set up FREE API keys. Choose one or multiple providers for better reliability.

Option 1: Groq API (Recommended - Best Performance)

Why use Groq?

✅ 10,000+ free requests/month
✅ Very fast responses (under 1 second)
✅ Easy setup
✅ Most reliable free tier

How to get API key:

Visit: https://console.groq.com
Sign up with Google/GitHub
Go to "API Keys" section
Click "Create API Key"
Copy your key (starts with gsk_)

Option 2: OpenRouter API (Good Alternative)

Why use OpenRouter?

✅ 200+ free requests/day
✅ Multiple AI models available
✅ Good reliability

How to get API key:

Visit: https://openrouter.ai
Sign up with Google/GitHub
Go to Settings → API Keys
Create new key
Copy your key (starts with sk-or-v1-)

Option 3: Hugging Face API (Open Source Models)

Why use Hugging Face?

✅ Completely free
✅ Open source models
✅ No usage limits (but slower)

How to get API key:

Visit: https://huggingface.co
Create account
Go to Settings → Access Tokens
Create new token
Copy your key (starts with hf_)

Option 4: OpenAI API (Paid - Most Advanced)

Why use OpenAI?

✅ Best AI quality (GPT models)
✅ Very reliable
✅ Professional results

How to get API key:

Visit: https://platform.openai.com
Create account
Go to API Keys section
Create new key
Copy your key (starts with sk-)

⚙️ Complete Settings Configuration

Basic Settings (Required):

{
    "gitAutoCommit.enable": true,
    "gitAutoCommit.branch": "main",
    "gitAutoCommit.intervalMinutes": 10,
    "gitAutoCommit.useAI": true
}

AI Provider Settings (Choose one or more):

For Groq (Recommended):

{
    "gitAutoCommit.groqEnabled": true,
    "gitAutoCommit.groqApiKey": "gsk_your_actual_key_here",
    "gitAutoCommit.groqModel": "llama-3.1-8b-instant",
    "gitAutoCommit.groqPriority": 1
}

For OpenRouter:

{
    "gitAutoCommit.openrouterEnabled": true,
    "gitAutoCommit.openrouterApiKey": "sk-or-v1-your_actual_key_here",
    "gitAutoCommit.openrouterModel": "deepseek/deepseek-chat",
    "gitAutoCommit.openrouterPriority": 2
}

For Hugging Face:

{
    "gitAutoCommit.huggingfaceEnabled": false,
    "gitAutoCommit.huggingfaceApiKey": "hf_your_actual_key_here",
    "gitAutoCommit.huggingfaceModel": "microsoft/DialoGPT-large",
    "gitAutoCommit.huggingfacePriority": 3
}

For OpenAI:

{
    "gitAutoCommit.openaiEnabled": false,
    "gitAutoCommit.openaiApiKey": "sk-your_actual_key_here",
    "gitAutoCommit.openaiModel": "gpt-3.5-turbo",
    "gitAutoCommit.openaiPriority": 4
}

Advanced Settings (Optional):

{
    "gitAutoCommit.maxTokens": 120,
    "gitAutoCommit.logLevel": "info",
    "gitAutoCommit.showNotifications": true
}

Complete Example Settings:

{
    "gitAutoCommit.enable": true,
    "gitAutoCommit.branch": "main",
    "gitAutoCommit.intervalMinutes": 10,
    "gitAutoCommit.useAI": true,
    "gitAutoCommit.maxTokens": 120,
    
    "gitAutoCommit.groqEnabled": true,
    "gitAutoCommit.groqApiKey": "gsk_your_groq_key_here",
    "gitAutoCommit.groqModel": "llama-3.1-8b-instant",
    "gitAutoCommit.groqPriority": 1,
    
    "gitAutoCommit.openrouterEnabled": true,
    "gitAutoCommit.openrouterApiKey": "sk-or-v1-your_openrouter_key_here",
    "gitAutoCommit.openrouterModel": "deepseek/deepseek-chat",
    "gitAutoCommit.openrouterPriority": 2,
    
    "gitAutoCommit.huggingfaceEnabled": false,
    "gitAutoCommit.huggingfaceApiKey": "hf_your_huggingface_key_here",
    "gitAutoCommit.huggingfaceModel": "microsoft/DialoGPT-large",
    "gitAutoCommit.huggingfacePriority": 3,
    
    "gitAutoCommit.openaiEnabled": false,
    "gitAutoCommit.openaiApiKey": "sk-your_openai_key_here",
    "gitAutoCommit.openaiModel": "gpt-3.5-turbo",
    "gitAutoCommit.openaiPriority": 4,
    
    "gitAutoCommit.logLevel": "info",
    "gitAutoCommit.showNotifications": true
}

🎯 How Each AI Provider Works

🔥 Groq (Priority 1 - Default)

Speed: ⚡ Very Fast (under 1 second)
Cost: Free (10,000 requests/month)
Best For: Daily development, quick commits
Model: llama-3.1-8b-instant (fast and smart)
When to use: Primary choice for all users

🌐 OpenRouter (Priority 2 - Backup)

Speed: 🚀 Fast (2-5 seconds)
Cost: Free (200 requests/day)
Best For: Reliable backup, different AI models
Model: deepseek/deepseek-chat (excellent for code)
When to use: When Groq is down or quota exceeded

🐢 Hugging Face (Priority 3 - Fallback)

Speed: 🐢 Slow (10-30 seconds)
Cost: Completely Free
Best For: Emergency fallback, no budget
Model: microsoft/DialoGPT-large (good for conversations)
When to use: Only when other providers fail

🧠 OpenAI (Priority 4 - Premium)

Speed: 🚀 Fast (2-5 seconds)
Cost: Paid (~$0.002 per request)
Best For: Professional use, best quality
Model: gpt-3.5-turbo (most intelligent)
When to use: For important projects with budget

🎯 How to Use

Method 1: AI Commit (Recommended)

Smart AI-powered commits with automatic provider fallback

Edit your code and save files
Click "🤖 AI Commit & Push" button
Extension automatically:
- Tries Groq first (fastest)
- If Groq fails, tries OpenRouter
- If OpenRouter fails, tries Hugging Face
- Generates professional commit message
- Commits and pushes automatically

Method 2: Quick Commit (Fast)

Instant commits without AI

Edit your code and save files
Click "⚡ Quick Commit" button
Extension automatically:
- Creates timestamp-based commit message
- Commits and pushes instantly

Method 3: Auto Mode (Hands-Free)

Set it and forget it

Turn ON "Auto Commit" toggle
Set interval (1-120 minutes)
Enable "AI Commit Messages"
Extension works automatically at intervals

⚙️ Settings Explained

Core Settings:

gitAutoCommit.enable - Turn entire extension ON/OFF
gitAutoCommit.branch - Which branch to push to (default: main)
gitAutoCommit.intervalMinutes - Auto commit frequency (1-120)
gitAutoCommit.useAI - Enable/disable AI commit messages

AI Provider Settings:

gitAutoCommit.groqEnabled - Enable Groq AI
gitAutoCommit.groqApiKey - Your Groq API key
gitAutoCommit.groqModel - AI model to use
gitAutoCommit.groqPriority - Execution order (1=first)
gitAutoCommit.openrouterEnabled - Enable OpenRouter AI
gitAutoCommit.openrouterApiKey - Your OpenRouter API key
gitAutoCommit.openrouterModel - AI model to use
gitAutoCommit.openrouterPriority - Execution order (2=second)
gitAutoCommit.huggingfaceEnabled - Enable Hugging Face AI
gitAutoCommit.huggingfaceApiKey - Your Hugging Face token
gitAutoCommit.huggingfaceModel - AI model to use
gitAutoCommit.huggingfacePriority - Execution order (3=third)
gitAutoCommit.openaiEnabled - Enable OpenAI
gitAutoCommit.openaiApiKey - Your OpenAI API key
gitAutoCommit.openaiModel - AI model to use
gitAutoCommit.openaiPriority - Execution order (4=fourth)

Advanced Settings:

gitAutoCommit.maxTokens - Maximum AI response length
gitAutoCommit.logLevel - Debug information level
gitAutoCommit.showNotifications - Show success/failure messages

🎯 Smart AI Fallback System

The extension uses an intelligent fallback system:

When AI Commit is triggered:
1. ✅ Check Groq (Priority 1) → If works, use it
2. ❌ If Groq fails → Check OpenRouter (Priority 2)
3. ❌ If OpenRouter fails → Check Hugging Face (Priority 3)  
4. ❌ If all fail → Use conventional commit message

This ensures you always get a commit, even if AI services are down.

❓ Frequently Asked Questions

Q: Which AI provider should I use?

A: Start with Groq (free and fast). Add OpenRouter as backup. Use Hugging Face only if you want completely free option.

Q: What if I don't set up any API keys?

A: The extension will use conventional commit messages without AI.

Q: How does the priority system work?

A: Lower priority number = tried first. Groq(1) → OpenRouter(2) → HuggingFace(3) → OpenAI(4)

Q: Can I use multiple providers?

A: Yes! Enable multiple providers for better reliability.

Q: What if all AI providers fail?

A: Extension automatically falls back to conventional commit messages.

Q: Is my API key secure?

A: Yes, keys are stored in VS Code settings and never sent to our servers.

🎉 Pro Tips

Use Groq as primary - Fastest and most reliable free option
Enable OpenRouter as backup - For when Groq quota exceeds
Set reasonable intervals - 10-15 minutes for active development
Monitor status panel - See which AI provider is being used
Use pause feature - During meetings or breaks

🔗 Useful Links

📖 Documentation: https://github.com/safimiazi/auto-push
🐛 Report Issues: https://github.com/safimiazi/auto-push/issues
🔑 Groq API: https://console.groq.com
🔑 OpenRouter: https://openrouter.ai
🔑 Hugging Face: https://huggingface.co
🔑 OpenAI: https://platform.openai.com

Auto Push created with ❤️ by Mohebulla Miazi Shafi

⭐ If you love this extension, please give it a star on GitHub!