ppush

---

ppush is a lightweight Python automation script designed to streamline your Git workflow. Stop typing three commands repeatedly—do it all with one

---

Features

• Auto Git Init: If no .git folder is detected, the script offers to initialize it and link it to a GitHub URL immediately
• Smart Commits: Supports commit messages via arguments (ppush "message") or interactive input
• Visual Feedback: Clean, colored status indicators ([Success], [Error], [Info]) for better readability
• Auto-branching: Automatically detects the current active branch and pushes directly to it
• Remote Origin Check: Even if the .git folder already exists (e.g. after a manual git init), the script will automatically check if it has a remote origin set.
  • If it is missing, it will prompt you to enter it.
  • It will automatically set the branch to main and link it to GitHub.

Usage

ppush

Standard push with interactive commit message.

--help

Shows a list of commands

--refresh

Fetch new version from this github repo.

--version

Shows current version of ppush.

Setup

1. Clone this repo
2. Run the provided installation bash script:

   chmod +x ppush_setup.sh
   ./ppush_setup.sh

Issues after update?

if ppush --version still shows the old version after a refresh, it's likely a PATH priority or caching issue.

1. Clear the shell cache: Your terminal might still remember the old location of the script. Run this to reset it:

hash -r

2. Check your PATH: Ensure your local bin directory is at the beginning of your $PATH. Add this to your .bashrc:

export PATH="$HOME/.local/bin:$PATH"

Then apply the changes:

source .bashrc

3. Remove old global versions: if you previously installed ppush using sudo, the old version in /usr/local/bin might be overriding your local one. Remove it:

sudo rm /usr/local/bin/ppush

Requirements

• Python 3.11 or higher
• colorama library
• Have installed git on your system

Contributing

Contributions are welcome! If you'd like to help improve ppush, please read the CONTRIBUTING.md file to understand how to get started, report bugs, or submit your own pull requests.