What problem does it solve?
Ensures that a local ticket branch is reliably published to the remote repository and configured with an upstream so collaborators and CI can see and build the work, avoiding accidental detached pushes in multi-worktree setups.
Core Features & Use Cases
- Resolve branch identity from a provided worktree path or explicit branch name and detect detached HEAD states.
- Check whether an upstream exists and perform a conditional push that sets upstream for new branches or pushes to the existing upstream.
- Handle common push failures by attempting a rebase and re-push, report conflicts and authentication issues, and verify the pushed commit on origin.
- Use Case: From a ticket worktree, push the current branch to origin with upstream tracking so the PR and CI appear automatically.
Quick Start
Use the git-push-remote skill to push the ticket worktree branch to origin and set upstream tracking if it is missing.