Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

git town up

git town up [-m | --merge] [-v | --verbose]

The up command moves one position up in the current stack by switching to a child of the current branch. After successfully switching branches, it displays the branch hierarchy to show your new position in the stack.

When the current branch has multiple children, an interactive dialog lets you choose which child branch to switch to.

git town up is useful for navigating stacked changes without needing to remember branch names or use the interactive switch command.

Examples

Consider this stack:

main \ * branch-1 \ branch-2

After running git town up on the branch-1 branch, you end up with this stack:

main \ branch-1 \ * branch-2

Options

-m
--merge

The --merge aka -m flag has the same effect as the git checkout -m flag. It attempts to merge uncommitted changes in your workspace into the target branch.

This is useful when you have uncommitted changes in your current branch and want to move them up to a child branch.

-v
--verbose

The --verbose aka -v flag prints all Git commands run under the hood to determine the repository state.

See also

  • branch displays the branch hierarchy
  • down moves one position down in the current stack
  • switch interactively switch between branches
  • swap changes the stack by swapping the position of current branch with its parent