# git-nav-upstream(1) Manual Page

## NAME

git-nav-upstream - Checkout the upstream branch of the currently checked out branch.

## SYNOPSIS

    git nav-upstream

## DESCRIPTION

git-nav-upstream takes the current branch, finds it's upstream branch, and checks that out.

## EXAMPLE

    $ git map-branches
    origin/main
      cool_feature
        subfeature *
      fixit
        frozen_branch

    $ git nav-upstream
    Switched to branch 'cool_feature'
    Your branch is ahead of 'origin/main' by 4 commits.
      (use "git push" to publish your local commits)

    $ git map-branches
    origin/main
      cool_feature *
        subfeature
      fixit
        frozen_branch

    $ git nav-upstream
    Note: switching to 'origin/main'.

    You are in 'detached HEAD' state. You can look around, make experimental <1>
    changes and commit them, and you can discard any commits you make in this
    state without impacting any branches by switching back to a branch.

    If you want to create a new branch to retain commits you create, you may
    do so (now or later) by using -c with the switch command. Example:

      git switch -c <new-branch-name>

    Or undo this operation with:

      git switch -

    Turn off this advice by setting config variable advice.detachedHead to false

    HEAD is now at beec6f4 Make ReflectorImpl use mailboxes

    $ git map-branches
    origin/main
      cool_feature
        subfeature
      fixit
        frozen_branch

1. Note that being in a detached HEAD state is OK. You’ll just want to create a git-new-branch(1) from here.

## SUGGESTED ALIASES

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

    [alias]
      up = nav-upstream

## SEE ALSO

git-map-branches(1), git-nav-downstream(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.