flow

A small Git/GitHub workflow helper.

Prerequisites

• Go 1.22+
• GitHub CLI (gh), authenticated via gh auth login

Install

Clone the repo and install the binary into your GOBIN (typically ~/go/bin):

git clone https://github.com/plinehan/flow.git
cd flow
go install .

Make sure ~/go/bin is on your PATH:

export PATH="$PATH:$(go env GOBIN):$(go env GOPATH)/bin"

Development

Install pre-commit and enable the hooks:

uv add --dev pre-commit
uv run pre-commit install

Commands

• flow branch [name] — create and check out a new branch (<user>/<name> or a random slug)
• flow create [-v] — push the current branch and open a PR (-v opens it in the browser)
• flow view — open the current branch's PR in the browser
• flow update — update the current branch's PR title and description from the HEAD commit message
• flow amend — amend all changes into the HEAD commit, rebase onto the latest default branch, then force-push
• flow merge — auto-squash-merge the current branch's PR, then return to the default (e.g. main) branch
• flow rebase — rebase the current branch onto the latest default branch
• flow push — force-push the current branch (refused on the default branch)
• flow clean — delete local branches whose PRs have been merged
• flow prune — prune remote-tracking branches that no longer exist on origin
• flow dirty — show the stash list and all local branches