Skip to main content

User-friendly Git CLI automation tool with interactive menus and visual feedback

Project description

GitCLI - Git Operations Automation

A user-friendly command-line interface for Git operations with interactive menus, visual feedback, and cross-platform support.

Features

  • 🎨 Colored output and loading spinners
  • 🔔 System notifications (macOS/Linux/Windows)
  • ⌨️ Tab completion in interactive mode
  • 🛡️ Safety checks for destructive operations
  • 🖥️ Cross-platform (macOS, Linux, Windows)
  • 🚀 Direct command execution or interactive mode

Installation

pip install gitcli-automation

Quick Start

Interactive Mode

gitcli

Direct Commands

gitcli status
gitcli commit
gitcli push
gitcli qp              # quick push: stage + commit + push
gitcli sync            # pull + push

Available Commands

Core Operations

  • commit - Commit staged changes
  • push - Push to remote (with force push option)
  • pull - Pull latest changes
  • sync - Pull then push in one command
  • fetch - Fetch updates without merging
  • stage - Stage changes (all or specific files)
  • status - Show git status
  • log - View commit history
  • diff - Show unstaged changes
  • diff-staged - Show staged changes

Branch Management

  • switch-branch - Switch to another branch
  • add-branch - Create new branch
  • delete-branch - Delete a branch
  • rename-branch - Rename a branch
  • list-branch - List all branches

Quick Operations

  • quick-push or qp - Stage, commit & push in one go

Advanced

  • amend - Amend last commit
  • reset - Reset to previous commit
  • remotes - Manage remote repositories
  • clone - Clone a repository

Command Flexibility

Commands work with spaces, hyphens, or no spaces:

gitcli list-branch    # ✅
gitcli listbranch     # ✅
gitcli list branch    # ✅

Examples

Quick workflow:

gitcli qp

Standard workflow:

gitcli status
gitcli diff
gitcli stage
gitcli commit
gitcli push

Branch workflow:

gitcli add-branch feature-x
# ... make changes ...
gitcli qp
gitcli switch-branch main

Requirements

  • Python 3.7+
  • Git installed and configured

Safety Features

  • Confirmation prompts for destructive operations
  • Branch protection (can't delete current branch)
  • Force push requires typing "yes"
  • Remote validation before push/pull

Contributing

Contributions welcome! Visit the GitHub repository.

License

MIT License - see LICENSE file for details.

Author

Adelodunpeter - GitHub

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitcli_automation-1.0.0.tar.gz (12.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gitcli_automation-1.0.0-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

Details for the file gitcli_automation-1.0.0.tar.gz.

File metadata

  • Download URL: gitcli_automation-1.0.0.tar.gz
  • Upload date:
  • Size: 12.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for gitcli_automation-1.0.0.tar.gz
Algorithm Hash digest
SHA256 3f77c408a0e9756859a0a8ac3224aa1a1cd4cd9f4857b9a044efa2138e535a7a
MD5 e646b494ee86e96e94ca474b20a0440b
BLAKE2b-256 aebd741225f3cc60189388ea56f2a3abe7593ffa80382c6fa2ab774ce91c39f9

See more details on using hashes here.

File details

Details for the file gitcli_automation-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for gitcli_automation-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e17aa9724bd74c83efecde3bf0ef8e1d6b4f4dce7bca535184eecf8b6d89d0fb
MD5 245334b7163513c5cf4f90b2d31d325c
BLAKE2b-256 225f43bac580316d800b7bd448c313f6036484374293d0ba6e042ba96eda043b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page