The smart, safe, and automated Git workflow CLI.
# YOLO (Universal Shell Script for Linux / macOS / Windows Git Bash)
curl -sL https://raw.githubusercontent.com/V-Bach/bettergit/main/install.sh | bash
# Package managers
npm install -g @vuthebach/gitv-cli # Node.js
brew tap V-Bach/gitv && brew install gitv # macOS and Linux# Windows (Scoop)
scoop bucket add gitv https://github.com/V-Bach/gitv-bucket.git
scoop install gitvTip
Gitv treats your source code as sacred. It will only commit files you have explicitly staged (no automatic git commit -a).
Inside any Git repository, simply run:
gitvThat's it. Gitv will analyze the repository context, determine what needs to be done (e.g., commit staged files, pull remote changes, push), and execute the plan safely.
- Context-Aware Routing: Intelligently detects if you need to commit, pull, push, stash, or resolve conflicts.
- Predictive Safety Validator: Simulates operations before executing them to ensure your repository never ends up in a corrupted state.
- Rich, Readable UI: Color-coded, emoji-free, professional terminal diagnostics that show exactly what’s happening.
- Resilient Crash Recovery: Interrupt a sync? Gitv knows where it left off and safely resumes the operation.
- Zero Implicit Commits: Never automatically stages all files. Gitv respects what you explicitly added to the index.
Gitv exists to collapse daily Git boilerplate into a single, intelligent command. Unlike traditional Git wrappers that blindly run git commit -am, Gitv uses a deterministic Acyclic Strategy Graph to understand your repository's exact state, predict the outcome of operations, and safely sync your work—all while respecting your explicit staging intent.
Instead of nested branching logic, Gitv translates repository state signals into a distinct ModuleIntent. This intent is then mapped to an ExecutionPlan—a linear sequence of isolated steps. Before anything runs, a SafetyValidator verifies the plan against current system constraints. This strict separation of decision-making, planning, and execution ensures that Gitv behaves predictably in every possible edge case.
For more info on how to configure Gitv in our docs/ directory.
We welcome contributions! Whether it's reporting a bug, proposing a new feature, or submitting a Pull Request, your help is appreciated.
- Fork the repo
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Aliases are blind. They execute sequentially regardless of context. Gitv reads the repository context first to decide which commands are safe and necessary to run.
No. Gitv only automates standard, safe Git operations. It does not perform complex history rewrites without explicit instruction.
Yes. Gitv is designed to be headless-friendly with the appropriate flags for non-interactive automation.
Distributed under the MIT License. See LICENSE for more information.