ghit Command Line Utility

Features

• Stack display with ghit ls or ghit -v ls shows:
  • 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/stack with the current branch as the main branch
  • adds .ghit/.gitignore
• 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 submit or ghit 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

Installation

python3 -m pip install ghit-smartptr

Example Flow

localhost:my-git-repo (main)$ ghit init
localhost:my-git-repo (main)$ cat .ghit/stack 
main

localhost: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-feature

localhost: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 git@github.com: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-feature

localhost:my-git-repo (new-feature)$ ghit top
Checked-out main.
localhost:my-git-repo (main)$ ghit ls
⯈ main
  └─ new-feature #73 (OPEN)✓ new-feature