run-git 1.0.6

Git Made Easy - One Command To Rule Them All

RUN-GIT - Git Made Easy 🚀

╭━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╮
┃                                                                    ┃
┃    ██████╗ ██╗   ██╗███╗   ██╗      ██████╗ ██╗████████╗         ┃
┃    ██╔══██╗██║   ██║████╗  ██║     ██╔════╝ ██║╚══██╔══╝         ┃
┃    ██████╔╝██║   ██║██╔██╗ ██║     ██║  ███╗██║   ██║            ┃
┃    ██╔══██╗██║   ██║██║╚██╗██║     ██║   ██║██║   ██║            ┃
┃    ██║  ██║╚██████╔╝██║ ╚████║     ╚██████╔╝██║   ██║            ┃
┃    ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝      ╚═════╝ ╚═╝   ╚═╝            ┃
┃                                                                    ┃
┃   ═══════════════════════════════════════════════════════════     ┃
┃                                                                    ┃
┃   ⚡ Git Operations Made Effortless                               ┃
┃   🎯 One Command | Zero Hassle | Full Control                     ┃
┃                                                                    ┃
┃   ┌──────────────────────────────────────────────────────────┐   ┃
┃   │  Developer    : Himanshu Kumar                           │   ┃
┃   │  GitHub       : @himanshu231204                          │   ┃
┃   │  Repository   : github.com/himanshu231204/gitpush        │   ┃
┃   │  Version      : v1.0.6                                   │   ┃
┃   │  License      : MIT                                      │   ┃
┃   └──────────────────────────────────────────────────────────┘   ┃
┃                                                                    ┃
┃   Type 'run-git help' to get started                              ┃
┃                                                                    ┃
╰━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╯

One Command To Rule Them All

RUN-GIT is the ultimate Git automation tool designed to make Git operations effortless for developers of all skill levels. Say goodbye to complex Git commands and hello to simplicity!

Created by Himanshu Kumar (@himanshu231204)

---

🎯 Features

• ⚡ Quick Push: One command to add, commit, pull, and push
• 🤖 Auto Commit Messages: Intelligent commit message generation
• 🔀 Interactive Conflict Resolution: Easy-to-use conflict handling
• 🌿 Branch Management: Create, switch, delete, and merge branches effortlessly
• 📊 Beautiful Status Display: Rich terminal UI with colors and tables
• 🔐 Sensitive File Detection: Warns about .env, secrets, and credentials
• 🎨 Interactive Mode: Full TUI menu for all operations
• 🆕 GitHub Repo Creation: Create repositories directly from command line or interactive menu
• 🔄 Smart Push Retry: Automatic conflict resolution and retry mechanism

---

📦 Installation

pip install run-git

---

🚀 Quick Start

1. Initialize Repository

# New repository
run-git init
 
# Clone existing repository
run-git init https://github.com/user/repo.git

2. Quick Push (Most Common Use Case)

# Add, commit, pull, and push in one command!
run-git push
 
# With custom commit message
run-git push -m "Add new feature"

3. Interactive Mode

# Just type run-git for interactive menu
run-git

New in v1.0.6: Interactive menu now includes "Create New Repo"! 🎉

? What would you like to do?
  🚀 Quick Push
❯ 🆕 Create New Repo  ← Access repo creation here!
  🌿 Branch Operations
  📊 View Status/History
  ⚙️  Configuration
  🔧 Advanced Tools
  📚 Help & Docs
  Exit

4. Create GitHub Repository

Two Ways to Create Repos:

Option 1: Interactive Menu (NEW!)

run-git
# Select "🆕 Create New Repo"
# Follow guided prompts

Option 2: Command Line

# Quick mode with smart defaults
run-git new my-awesome-project --quick
 
# Interactive mode
run-git new my-project

---

🆕 GitHub Repository Creation

Create GitHub repositories directly from your terminal without opening a browser!

⚙️ One-Time Setup

Before using repo creation, you need a GitHub Personal Access Token (only once):

Step 1: Create GitHub Token

1. Go to: https://github.com/settings/tokens
2. Click "Generate new token (classic)"
3. Give it a name: run-git-token
4. Select scopes:
   • ✅ repo (Full control of private repositories)
   • ✅ user (Read user profile data)
5. Click "Generate token"
6. Copy the token (starts with ghp_...) ⚠️ You won't see it again!

Step 2: First Time Use

run-git new my-first-repo --quick

You'll be prompted:

ℹ️  GitHub Personal Access Token needed!
ℹ️  Create one at: https://github.com/settings/tokens
ℹ️  Required scopes: repo, user
? Enter your GitHub token: 

Paste your token (won't show while typing) and press Enter.

✅ Authenticated as: your-username
✅ GitHub token saved securely

That's it! Your token is now saved. You'll never be asked again! 🎉

Token Storage

Token is securely stored in:

• Linux/Mac: ~/.run-git/config.yml
• Windows: C:\Users\YourName\.run-git\config.yml

File permissions are set to user-only (600) for security.

---

💡 Creating Repositories

Method 1: Interactive Menu (Recommended for Beginners)

run-git

Select "🆕 Create New Repo" from the menu.

You'll be guided through:

1. Repository name
2. Description
3. Public or Private
4. Gitignore template (auto-detected!)
5. License selection
6. README creation

Full interactive experience with beautiful UI! ✨

Method 2: Quick Mode CLI

# Create repo with smart defaults
run-git new my-awesome-project --quick

What it does:

• ✅ Detects language from your files (Python, Node, Java, etc.)
• ✅ Creates .gitignore automatically
• ✅ Adds MIT license
• ✅ Generates professional README
• ✅ Makes repository public
• ✅ Pushes to GitHub
• ✅ All in 5 seconds!

Method 3: Interactive CLI

# Answer questions for each option
run-git new my-project

Method 4: Full Command Line

# Specify everything upfront
run-git new my-api \
  --description "REST API for my app" \
  --public \
  --gitignore Python \
  --license MIT

📋 Available Options

Option	Description
--quick	Use smart defaults, no prompts
-d, --description	Repository description
--public	Make repository public (default)
--private	Make repository private
-g, --gitignore	Gitignore template (Python, Node, Java, etc.)
-l, --license	License (MIT, Apache-2.0, GPL-3.0, BSD, ISC)
--no-readme	Skip README creation

🎬 Example Workflow

# Create new project folder
mkdir my-web-app
cd my-web-app
 
# Add some files
echo "print('Hello')" > app.py
echo "flask" > requirements.txt
 
# Create repo via interactive menu
run-git
# Select "🆕 Create New Repo"
 
# OR use CLI quick mode
run-git new my-web-app --quick

Output:

✅ Using smart defaults...
ℹ️  Language detected: Python
ℹ️  License: MIT
ℹ️  Visibility: Public
⏳ Creating repository on GitHub...
✅ Repository created: https://github.com/you/my-web-app
⏳ Initializing local repository...
✅ .gitignore (Python) created
✅ LICENSE (MIT) created
✅ README.md created
⏳ Setting up main branch...
⏳ Pushing to GitHub...
✅ Repository pushed successfully!
🎉 Repository created successfully!
🔗 https://github.com/you/my-web-app

Your repo is LIVE on GitHub! 🚀

---

🔄 Smart Push with Automatic Retry (NEW in v1.0.6)

Repository creation now includes intelligent push handling:

• Automatic Branch Management: Always uses main branch
• Conflict Auto-Resolution: Syncs with remote if there are conflicts
• Retry Logic: Attempts multiple strategies to push successfully
• Graceful Failure: Clear instructions if manual intervention needed

Example:

⏳ Pushing to GitHub...
⚠️  Push failed. Attempting to sync with remote...
✅ Repository synced and pushed successfully!

---

📖 Usage

Basic Commands

# Push changes
run-git push
 
# View status
run-git status
 
# View commit history
run-git log
 
# Branch operations
run-git branch              # List branches
run-git branch feature-x    # Create branch
run-git switch main         # Switch branch
run-git merge feature-x     # Merge branch
 
# Remote management
run-git remote              # Show remotes
run-git remote origin --add https://github.com/user/repo.git
 
# Advanced
run-git pull                # Pull changes
run-git sync                # Pull + Push
run-git stash               # Stash changes
run-git undo                # Undo last commit

---

🤖 Auto Commit Messages

RUN-GIT generates intelligent commit messages based on your changes:

• feat: add authentication module (3 added)
• fix: update user validation (2 modified)
• docs: update README (1 modified)
• refactor: remove deprecated code (2 deleted)

---

🎯 Use Cases

For Beginners

• No need to remember complex Git commands
• Interactive menus guide you through operations
• Auto-generated commit messages
• Create GitHub repos without leaving terminal
• Built-in help and guidance

For Experienced Developers

• Fast one-command push workflow
• Customizable commit messages
• Time-saving automation
• Quick repo creation for new projects
• Smart conflict resolution

---

📚 Command Reference

Command	Description
run-git	Interactive mode (with Create Repo option!)
run-git push	Quick push (add, commit, pull, push)
run-git new <n>	Create new GitHub repository
run-git init	Initialize repository
run-git status	Show repository status
run-git log	Show commit history
run-git branch	List branches
run-git switch <n>	Switch branch
run-git merge <n>	Merge branch
run-git remote	Show remotes
run-git pull	Pull changes
run-git sync	Pull and push
run-git stash	Stash changes
run-git undo	Undo last commit
run-git --help	Show help
run-git --version	Show version

---

🔧 Troubleshooting

Token Issues

Q: I lost my token, how do I create a new one?

A: Delete the saved token and run any repo creation command:

# Linux/Mac
rm ~/.run-git/config.yml
 
# Windows
del %USERPROFILE%\.run-git\config.yml
 
# Then run
run-git new test-repo --quick

Q: How do I update my token?

A: Same as above - delete the config file and enter a new token.

Q: Is my token secure?

A: Yes! The token is:

• Stored locally on your machine only
• File permissions set to user-only (600)
• Never transmitted except to GitHub's official API
• Can be revoked anytime from GitHub settings

Push Issues

Q: What if push fails?

A: RUN-GIT automatically:

1. Attempts standard push
2. If fails, syncs with remote using --allow-unrelated-histories
3. Retries push
4. If still fails, provides manual instructions

Q: Repository created but push failed?

A: You can manually push:

git push -u origin main

---

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

👨‍💻 Author

Himanshu Kumar

• GitHub: @himanshu231204
• Created with ❤️ for the developer community

---

🌟 Show Your Support

If you find RUN-GIT helpful, please:

• ⭐ Star the repository
• 🐛 Report bugs
• 💡 Suggest new features
• 🔀 Contribute code

---

📊 Why RUN-GIT?

The Problem

Git is powerful but complex. Beginners struggle with:

• Remembering command sequences
• Handling merge conflicts
• Writing good commit messages
• Managing branches
• Creating GitHub repositories
• Dealing with push failures

The Solution

RUN-GIT provides:

• ✅ One command for common workflows
• ✅ Interactive conflict resolution
• ✅ Auto-generated commit messages
• ✅ Beautiful terminal UI
• ✅ Safety features
• ✅ Zero learning curve
• ✅ One-command GitHub repo creation
• ✅ Interactive menu for easy access
• ✅ Smart push retry mechanism

---

📈 What's New in v1.0.6

🆕 New Features

• Interactive Menu Integration: Create repos directly from run-git interactive menu
• Smart Push Retry: Automatic conflict resolution and retry on push failures
• Better Branch Management: Ensures main branch naming consistency

🔧 Improvements

• Enhanced push reliability with automatic sync
• Better error messages and recovery options
• Improved file staging mechanism
• More robust conflict handling

🐛 Bug Fixes

• Fixed push failures when remote has diverged
• Improved error handling for repository state conflicts
• Better handling of branch naming inconsistencies

---

Made with ❤️ by Himanshu Kumar | Making Git Easy for Everyone