# git-nav-downstream(1) Manual Page

## NAME

git-nav-downstream - Checkout a downstream branch of the currently checked out branch.

## SYNOPSIS

    git nav-downstream

## DESCRIPTION

git-nav-downstream takes the current branch and discovers all branches downstream of it. If there is only one branch downstream of the current branch, the command will check that out. If there's more than one downstream branch, the command will prompt you with a selection of the branches.

## EXAMPLE

    $ git map-branches
    origin/main
      cool_feature
        subfeature
      fixit
        frozen_branch
    $ git nav-downstream
    Previous HEAD position was beec6f4 Make ReflectorImpl use mailboxes
    Switched to branch 'cool_feature'
    Your branch is ahead of 'origin/main' by 4 commits.
      (use "git push" to publish your local commits)
    Please select a downstream branch
      0. cool_feature
      1. fixit
    Selection (0-1)[0]: 0
    $ git map-branches
    origin/main
      cool_feature *
        subfeature
      fixit
        frozen_branch
    $ git nav-downstream
    Switched to branch 'subfeature'
    Your branch and 'cool_feature' have diverged,
    and have 2 and 1 different commits each, respectively.
      (use "git pull" to merge the remote branch into yours)
    $ git map-branches
    origin/main
      cool_feature
        subfeature *
      fixit
        frozen_branch

## SUGGESTED ALIASES

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

    [alias]
      down = nav-downstream

## SEE ALSO

git-map-branches(1), git-nav-upstream(1)

## 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.