- Stack display with
ghit lsorghit -v lsshows:- the branch tree
- the relation to the base branch state
- the PR state, if any
- the unresolved PR comments, if any
- Stack navigation (checkout):
ghit up,ghit down,ghit top,ghit bottom
- Stack initialization with
ghit init:- creates
.ghit/stackwith the current branch as the main branch - adds
.ghit/.gitignore
- creates
- Stack manipulation:
ghit branch create <name>:- create and switch to the new branch
- add the branch name to
.ghit/stack
- Stack or branch publication with
ghit stack submitorghit branch submit:- pushes branch(es) upstream with no force, so may fail after rebase
- creates or updates GitHub PR(s)
- creates or updates dependencies comment(s)
- Check stack with
ghit stack check:- branches in a stack sit on the heads of their parents
- suggests rebase commands
- suggests to delete local branches if there are merged or closed PRs
python3 -m pip install ghit-smartptrlocalhost:my-git-repo (main)$ ghit init
localhost:my-git-repo (main)$ cat .ghit/stack
mainlocalhost:my-git-repo (main)$ ghit branch create new-feature
Checked-out new-feature.
The branch doesn't have an upstream.
localhost:my-git-repo (new-feature)$ cat .ghit/stack
main
.new-featurelocalhost:my-git-repo (new-feature)$ git add .
localhost:my-git-repo (new-feature)$ git commit
localhost:my-git-repo (new-feature)$ ghit ls
main
⯈ └─ new-feature *
localhost:my-git-repo (new-feature)$ ghit stack submit
Pushed new-feature to remote [email protected]:me/my-git-repo.git.
Set upstream to origin/new-feature.
Created PR #73 (OPEN).
localhost:my-git-repo (new-feature)$ ghit ls
main
⯈ └─ new-feature #73 (OPEN)✓ new-featurelocalhost:my-git-repo (new-feature)$ ghit top
Checked-out main.
localhost:my-git-repo (main)$ ghit ls
⯈ main
└─ new-feature #73 (OPEN)✓ new-feature