SYNOPSIS

git map-branches

DESCRIPTION

Git map-branches displays all local branches such that:

  • Current branch is cyan.

    • The branch which will be modified with git-commit is denoted with an asterisk (*) after the name.

  • Local branches are green.

  • Remote branches are red (usually, the root of all other branches).

  • branch-heads branches are blue.

  • {NO UPSTREAM} is a special placeholder in magenta.

    • Branches which have this as their parent are usually misconfigured, and should be assigned a parent by checking out the branch and running git branch --set-upstream-to=<correct parent branch>.

Note
If multiple branches are on the same commit, they will all be cyan.

OPTIONS

--no-color

Turn off colors.

-v

Be more verbose. Pass once to show tracking info, twice for hash and review URL, thrice for review status.

EXAMPLE

Given the hypothetical demo repo in git-map(1)'s EXAMPLE section, and assuming that the frozen_changes branch was currently checked out, running git map-branches would result in an output like:

$ git map-branches
{NO_UPSTREAM}
  no_upstream
origin/main
  cool_feature
    subfeature
  fixit
    frozen_branch *

$ git map-branches -v
{NO_UPSTREAM}                                 
  no_upstream                                 
origin/main                                   
  cool_feature         [ 4 commits            ]
    subfeature         [ 2 commits | behind 1 ]
  fixit                [ 2 commits            ]
    frozen_branch *    [ 3 commits            ]

SUGGESTED ALIASES

Some common short-hand aliases. Feel free to add these to your ~/.gitconfig file.

[alias]
  bmap = map-branches

SEE ALSO

CHROMIUM DEPOT_TOOLS

Part of the chromium depot_tools(7) suite. These tools are meant to assist with the development of chromium and related projects. Download the tools by checking out the git repository.