🛠️ A smart, friendly CLI assistant for safely staging, committing, and pushing Git changes — with built-in teaching moments and power-user flags.
- Detects and stages untracked or modified files
- Prompts before committing and pushing
- Explains detached HEAD state when detected
- Prevents commits during merge conflicts
- Shows diff preview before commit (optional)
- Flags to suppress prompts and explanations
Open your terminal and run:
git clone git@github.com:aalbrightpdx/githelper.gitOr, if you prefer HTTPS:
git clone https://github.com/aalbrightpdx/githelper.gitcd githelperIn the project directory:
pipx install .Once installed, from any directory run:
githelper # Start interactive assistant
githelper --yes # Auto-confirm everything
githelper --no-explain # Skip explanations
githelper -h # Show helpExample workflow:
📦 Remote repository detected: git@github.com:your/repo.git
✅ Is this the correct repository you want to update? [y/n]: y
🔍 Checking git status...
✅ Stage all changes and continue? [y/n]: y
📝 Enter your commit message: Add CLI help flags
🚀 Ready to push to GitHub? [y/n]: y
🎉✅ All done! Your changes are pushed!Uninstall
pip uninstall githelper- Python 3.6+
- Git installed and available in your system PATH
MIT — free to use, modify, and share.