What problem does it solve?
Prevents local commits from being pushed when they would violate branch protection rules, have upstream problems, contain secrets or PII, or when the branch has diverged, avoiding accidental history corruption or secret leaks.
Core Features & Use Cases
- Branch protection gating: Detects protected branches and stops direct pushes, offering branch creation or PR options.
- Upstream and divergence checks: Detects missing or deleted upstreams and behind/ahead divergence to avoid unsafe pushes.
- Secret and PII scanning workflow: Uses commit diffs to scan only relevant files and refuses pushes with confirmed secret findings until approved.
- Platform-aware automation: Integrates with GitHub and Azure DevOps via CLI checks and suggests the appropriate PR workflow when needed.
Quick Start
Run the git-push workflow to gather push state, scan commits for secrets and divergence, and only proceed with git push after confirming findings.