git town down
git town down [(-d | --display-types) <type>] [-h | --help] [-m | --merge] [(-o | --order) <asc|desc>] [-v | --verbose]
The down command moves one position down 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 down 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 down on the branch-1 branch,
you end down with this stack:
main
\
branch-1
\
* branch-2
Options
-d <branch-types>
--display-types <branch-types>
This flag allows customizing whether Git Town also displays the branch type in addition to the branch name when showing a list of branches. More info here.
-h
--help
Display help for this command.
-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 down to a child branch.
-o <asc|desc>
--order <asc|desc>
The --order flag allows customizing the order in which branches get displayed.
More info here
-v
--verbose
The --verbose aka -v flag prints all Git commands run under the hood to
determine the repository state.