Stacked branch management for Git
Dual-licensed under MIT or Apache 2.0
Like Stacked-Diffs? git-stack is another approach to bringing the
Stacked Diff workflow
to PRs that aims to be unintrusive to a project's workflow. Branches are the unit
of work and review in git-stack. As you create branches on top of each
other (i.e. "stacked" branches), git-stack will takes care of all of the
micromanagement for you.
Unfamiliar with Stacked-Diffs? git-stack helps automate a lot of common
workflows when dealing with PRs, especially when you start to create PRs on top
of PRs.
Features:
- Upstream parent branch auto-detection
- Maintain branches relative to each other through rebase
- Defers all permanent changes until the end (e.g. HEAD, re-targeting
branches), always leaving you in a good state
(similar to git revise)
- Separates out pull/push remotes for working from a fork
- On --push, detects which branches are "ready" (e.g. root of stack, no WIP)
- Undo support: backs up branch state prior to rewriting history
Non-features
- Conflict resolution: git-stack will give up and you'll have to use
git rebase yourself to resolve the conflict.
To see how git-stack compares to other stacked git tools, see the Comparison.
From your development branch, run:
bash
jira-3423423 $ git-stack --pull
git-stack:
1. Auto-detects your parent remote branch (e.g. main).
2. Performs a git pull --rebase <remote> <parent>
3. Rebases jira-3423423 (and any dev branches on the stack) onto <parent>
4. Shows the stacked branches
The closest equivalent is:
bash
jira-3423 $ git checkout main
main $ git pull --rebase upstream main
main $ git checkout jira-3154
jira-3154 $ git rebase HEAD~~ --onto main
jira-3154 $ git checkout jira-3259
jira-3259 $ git rebase HEAD~ --onto jira-3154
jira-3259 $ git checkout jira-3423
jira-3423 $ git rebase HEAD~ --onto jurao-3259
jira-3423 $ git log --graph --all --oneline --decorate main..HEAD
Parent branch auto-detection works by separating the concept of upstream-controlled branches (called "protected branches") and your development branches.
Download a pre-built binary (installable via gh-install).
Or use rust to install:
bash
cargo install git-stack
git-stackProtected branches: run git-stack --protected -v to test your config
- To locally protect additional branches, run git-stack --protect <glob>.
- When adopting git-stack as a team, you can move the protected branches from
$REPO/.git/config to $REPO/.gitconfig and commit it.
Pull remotes when working from a fork (upstream is a different remote than
origin), in $REPO/.git/config, set stack.pull-remote to your remote.
To see the config, run git-stack --dump-config -.
For more, see Reference.
```bash
git-stack --pull
git switch -c feature1 git add -A; git commit -m "Work" git add -A; git commit -m "More Work" git add -A; git commit --fixup HEAD~~
git-stack
git-stack --push ```
git switch feature1 && git switch -v feature2 and start adding commitsgit rebase HEAD~~ --onto feature1git-stack --rebase --base HEAD~~ --onto featuregit commit --fixup
<ref> and then git-stack --rebase will move it to where it needs to be.git rebase -igit switch feature1 && git switch -c feature2 and start adding commitsHave an idea, we'd love to hear it!
There are probably git operations or workflows we haven't heard of and would
welcome the opportunity to learn more.
Currently, Github is limited to showing all commits for a branch, even if some of those commits are "owned" by another PR. We recommend only posting one PR at a time within a stack. If you really need to, you can direct your reviewers to the commits within each PR to look at. However, you will see the CI run status of top commit for each PR dependency.