gflow

A small shell tool for creating prefixed feature branches from a configured base branch, opening pull request pages, cleaning up finished local branches, and installing one shell integration file for Fish, Zsh, Bash, or a generic PATH setup.

curl -fsSL https://hasit.github.io/gflow/install.sh | sh

Commands

Command	Use
`gflow config prefix team/`	Save the branch prefix in local Git config.
`gflow config base trunk`	Save the base branch in local Git config.
`gflow config remote upstream`	Save the remote in local Git config.
`gflow config`	Show the effective repo settings.
`gflow new api-cleanup`	Create `team/api-cleanup` from the configured remote and base branch.
`gflow pr`	Push the current branch upstream and open a pull request page.
`gflow done team/api-cleanup`	Switch to the base branch, pull, delete the branch, and prune the remote.

Options

Setting	Scope	Purpose
`gflow.branch-prefix`	Repo	Store the branch prefix for this repository.
`gflow.main-branch`	Repo	Store the base branch for this repository.
`gflow.remote`	Repo	Store the remote for this repository.
`GFLOW_INSTALL_DIR`	Install	Change where the `gflow` executable is installed.
`GFLOW_SHELL`	Install	Force `fish`, `zsh`, `bash`, or generic PATH setup.
`GFLOW_BASE_URL`	Install	Fetch live files from a fork, mirror, or branch.
`GFLOW_MAIN_BRANCH`	Runtime	Override `gflow.main-branch` for the current command invocation.
`GFLOW_REMOTE`	Runtime	Override `gflow.remote` for the current command invocation.

Changelog

Date	Change
`2026-05-04`	Added `gflow config` and `gflow pr`, with repo-local settings and pull request URLs for recognized remote URL formats.
`2026-04-29`	Reworked shell integration into installable Bash, Fish, and Zsh files, added copyable website install instructions, and retired the older `gdone` shortcut.
`2026-04-28`	Launched the first workflow with branch prefixes, `gflow new`, `gflow done`, shell completions, an embedded installer, bundled fonts, and the static website.