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 changespush- Push to remote (with force push option)pull- Pull latest changessync- Pull then push in one commandfetch- Fetch updates without mergingstage- Stage changes (all or specific files)status- Show git statuslog- View commit historydiff- Show unstaged changesdiff-staged- Show staged changes
Branch Management
switch-branch- Switch to another branchadd-branch- Create new branchdelete-branch- Delete a branchrename-branch- Rename a branchlist-branch- List all branches
Quick Operations
quick-pushorqp- Stage, commit & push in one go
Advanced
amend- Amend last commitreset- Reset to previous commitremotes- Manage remote repositoriesclone- 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f77c408a0e9756859a0a8ac3224aa1a1cd4cd9f4857b9a044efa2138e535a7a
|
|
| MD5 |
e646b494ee86e96e94ca474b20a0440b
|
|
| BLAKE2b-256 |
aebd741225f3cc60189388ea56f2a3abe7593ffa80382c6fa2ab774ce91c39f9
|
File details
Details for the file gitcli_automation-1.0.0-py3-none-any.whl.
File metadata
- Download URL: gitcli_automation-1.0.0-py3-none-any.whl
- Upload date:
- Size: 13.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e17aa9724bd74c83efecde3bf0ef8e1d6b4f4dce7bca535184eecf8b6d89d0fb
|
|
| MD5 |
245334b7163513c5cf4f90b2d31d325c
|
|
| BLAKE2b-256 |
225f43bac580316d800b7bd448c313f6036484374293d0ba6e042ba96eda043b
|