AutoGit CLI

🚀 AutoGit is a powerful CLI tool that generates real GitHub contributions and creates AI-generated repositories. Build an impressive GitHub profile with authentic, interview-safe projects.

✨ Features

• 🔐 Secure Authentication - OAuth/token-based GitHub integration
• 🤖 AI Repository Generation - Create complete, runnable projects in multiple languages
• 📅 Smart Contribution Planning - Schedule realistic commit patterns
• 📊 Analytics & Insights - Track your progress and consistency
• 🛡️ Interview-Safe - All generated code is production-ready and defensible
• 🌍 Cross-Platform - Works on Windows, macOS, and Linux

🚀 Quick Start

Installation

npm install -g autogit-cli

Authentication

# Login with GitHub Personal Access Token
autogit auth login

# Check authentication status
autogit auth status

Create Your First Repository

# Interactive repository creation
autogit repo create

Plan Contributions

# Plan contribution schedule
autogit contribute plan

# Preview the plan
autogit contribute preview

# Execute the plan
autogit contribute execute

View Statistics

# Show detailed statistics
autogit stats

📋 Commands

Authentication Commands

| Command | Description | |---------|-------------| | autogit auth login | Login to GitHub with Personal Access Token | | autogit auth status | Check current authentication status | | autogit auth revoke | Revoke stored authentication |

Configuration Commands

| Command | Description | |---------|-------------| | autogit config setup | Interactive setup for AI and other settings | | autogit config show | Show current configuration | | autogit config reset | Reset configuration to defaults |

Repository Commands

| Command | Description | |---------|-------------| | autogit repo create | Create AI-generated repository with interactive prompts |

Contribution Commands

| Command | Description | |---------|-------------| | autogit contribute plan | Plan contribution schedule with date range and density | | autogit contribute preview | Preview planned contribution schedule | | autogit contribute execute | Execute the contribution plan |

Analytics Commands

| Command | Description | |---------|-------------| | autogit stats | Show comprehensive statistics and insights |

🎯 Supported Languages & Project Types

Languages

• Python - CLI, API, Library, Bot, Web App
• JavaScript - CLI, API, Library, Bot, Web App
• TypeScript - CLI, API, Library, Bot, Web App
• Go - CLI, API, Library, Bot, Web App
• Rust - CLI, API, Library, Bot, Web App
• Java - CLI, API, Library, Bot, Web App
• C++ - CLI, API, Library, Bot, Web App

Difficulty Levels

• Beginner - Simple, well-documented projects
• Intermediate - More complex features and patterns
• Advanced - Production-ready with advanced concepts

🔧 Configuration

AutoGit stores configuration in ~/.autogit/:

• config.json - Encrypted authentication data
• ai-config.json - AI model and API settings
• stats.json - Local statistics and progress

AI Configuration

AutoGit uses Qwen3 Coder 32B as the default model (FREE on OpenRouter):

# Setup AI configuration interactively
autogit config setup

# View current settings
autogit config show

# Reset to defaults
autogit config reset

Available Models:

• Qwen3 Coder 32B (FREE) - Optimized for code generation
• Qwen2.5 72B (FREE) - General purpose
• Claude 3 Haiku - Fast and cost-effective
• GPT-4o Mini - OpenAI's efficient model
• Custom models - Enter any OpenRouter-supported model

GitHub Token Setup

1. Go to GitHub Settings > Personal Access Tokens
2. Create a new token with these scopes:
   • repo - Full repository access
   • user - User profile access
   • delete_repo - Repository deletion (optional)
3. Use the token with autogit auth login

OpenRouter API Key Setup (Optional)

For enhanced AI-generated code, set up OpenRouter:

1. Get API Key:

   • Visit OpenRouter
   • Create account and get API key (many models are FREE!)

2. Configure API Key:

   # Option 1: Environment Variable (Recommended)
   export OPENROUTER_API_KEY="your_api_key_here"
      
   # Option 2: CLI Configuration
   autogit config setup

3. Default Model: Qwen3 Coder 32B (FREE) - Optimized for code generation

🛡️ Security & Safety

• No Password Storage - Only secure tokens are used
• Real Git Commits - Uses native Git CLI, not API manipulation
• User Confirmation - Explicit confirmation before any destructive actions
• Encrypted Storage - All sensitive data is encrypted locally
• Interview-Safe Code - Generated projects are production-ready

📊 Example Workflow

# 1. Setup authentication
autogit auth login

# 2. Configure AI (optional but recommended)
autogit config setup
# Enter OpenRouter API key for enhanced generation

# 3. Create a Python CLI project
autogit repo create
# Select: Python > CLI > Intermediate > my-awesome-tool

# 4. Plan 30 days of contributions
autogit contribute plan
# Select date range, density, and repositories

# 5. Preview the plan
autogit contribute preview

# 6. Execute contributions
autogit contribute execute

# 7. Check your progress
autogit stats

🎨 Generated Project Structure

Each generated repository includes:

• 📁 Complete Project Structure - Organized, professional layout
• 📝 Comprehensive README - Installation, usage, and examples
• 🧪 Test Suite - Unit tests and test configuration
• 📦 Dependency Management - Package files (package.json, requirements.txt, etc.)
• ⚙️ Configuration Files - Build tools, linters, formatters
• 📄 Documentation - LICENSE, .gitignore, and other essentials
• 🔄 Multiple Commits - Realistic development history

🤝 Contributing

AutoGit is designed to be safe and ethical:

1. No Fake Metrics - No artificial stars, forks, or followers
2. Real Contributions - All commits are genuine Git operations
3. Quality Code - Generated projects are interview and production-ready
4. Transparent Process - All actions require user confirmation

📈 Statistics Tracking

AutoGit tracks:

• Total contributions made
• Repositories created
• Language breakdown
• Weekly consistency score
• GitHub profile metrics
• Activity insights and recommendations

🔍 Troubleshooting

Common Issues

Authentication Failed

# Check token permissions and try re-authenticating
autogit auth revoke
autogit auth login

Repository Creation Failed

# Ensure unique repository name and check GitHub limits
autogit auth status

Contribution Execution Failed

# Check repository permissions and network connectivity
autogit stats

📝 License

MIT License - see LICENSE for details.

🌟 Why AutoGit?

• 🎯 Interview Preparation - Build a portfolio of diverse, quality projects
• 📈 GitHub Activity - Maintain consistent contribution patterns
• 🚀 Learning Tool - Explore different languages and project structures
• ⏰ Time Efficient - Generate months of realistic development history
• 🛡️ Ethical & Safe - Transparent, real contributions that you can defend

Ready to supercharge your GitHub profile? 🚀

npm install -g autogit-cli
autogit auth login
autogit repo create