Overview

RUN-GIT is a Python-powered CLI that simplifies Git workflows into single, intuitive commands. It handles the common add-commit-pull-push sequence automatically, generates meaningful commit messages, provides interactive branch management, and integrates with GitHub for repository creation.

Use case: Developers who run the same Git commands dozens of times daily and want a faster way to commit and push.

📦 Installation · 🚀 Quick Start · 📖 Commands · 🏗️ Architecture

Quick Push

One command does everything: run-git push

AI Assistant

Get AI-powered code reviews, PR descriptions, and commit messages directly from your terminal.

Features

Installation

pip install run-git

Requires Python 3.8+. Works on macOS, Linux, and Windows.

First time: Set your GitHub token with run-git init Upgrade: pip install --upgrade run-git

Quick Start

Push changes

run-git push                        # auto commit message + push
run-git push -m "feat: add login"  # custom commit message

Interactive menu

run-git          # full TUI — no commands to memorize

Create GitHub repository

run-git new my-project                              # guided wizard
run-git new my-project --quick                      # defaults, no prompts
run-git new my-api -d "REST API" --public -g Python -l MIT  # full options

Tag & Release

# Create a tag
run-git tag v1.0.0

# Create tag with message
run-git tag v1.0.0 -m "First stable release"

# Create tag + push to remote
run-git tag v1.0.0 --push

# One-click: Create tag + push + GitHub release
run-git tag v1.0.0 -r

# Create release with AI-generated notes
run-git tag v1.0.0 -r --ai

# Create draft release
run-git tag v1.0.0 -r --draft

# Release from existing tag
run-git release v1.0.0
run-git release v1.0.0 -t "Version 1.0.0" -b "Bug fixes and improvements"

Command Reference

Architecture

gitpush/
├── cli.py                 # Main CLI entry point (Click)
├── commands/              # Modular command handlers
│   ├── push.py           # Push command
│   ├── init.py           # Init command
│   ├── status.py         # Status & log commands
│   ├── branch.py         # Branch operations
│   ├── github.py         # GitHub integration
│   └── graph.py          # Commit graph visualization
├── core/                 # Business logic
│   ├── git_operations.py # Git operations
│   ├── commit_generator.py # Auto commit messages
│   └── conflict_resolver.py # Merge conflict handling
├── ui/                   # Terminal UI (Rich, questionary)
├── utils/                # Utilities (validators, formatters)
├── config/               # Configuration management
└── exceptions.py        # Custom exceptions

Design principles:

• Separation of concerns: commands/ (thin orchestration), core/ (business logic), ui/ (terminal rendering)
• Testable: Core logic independent of CLI dependencies
• Extensible: New commands added as isolated modules

Auto Commit Messages

RUN-GIT analyzes staged changes and generates Conventional Commits style messages:

feat: add authentication module (3 files added)
fix: update user validation logic (2 files modified)
docs: update README (1 file modified)
refactor: remove deprecated helper functions (2 files deleted)

Comparison

RUN-GIT is a speed layer on top of Git — not a replacement. Use it for daily work; reach for git or gh when you need fine-grained control.

Contributing

Contributions, bug reports, and feature requests are welcome.

# Clone and setup
git clone https://github.com/himanshu231204/run-git.git
cd gitpush

# Install in development mode
pip install -e ".[test]"

# Run tests
pytest

License

Distributed under the MIT License. See LICENSE for details.

Author

Himanshu Kumar — @himanshu231204