gs checkout

Smart branch checkout with interactive selection. Shows stack context for each branch.

# Interactive mode — select from list of branches
gs co
 
# Quick checkout to trunk
gs co -t
gs co --trunk
 
# Show untracked branches in selection
gs co -u
gs co --show-untracked
 
# Only show branches in current stack
gs co -s
gs co --stack

Aliases: co, checkout, switch

Relative navigation

Move through the stack along parent-child edges without knowing branch names.

Command	Alias	Description
`gs up [n]`	`u`	Move up toward leaves
`gs down [n]`	`dn`	Move down toward trunk
`gs top`	`t`	Jump to top of stack
`gs bottom`	`b`	Jump to trunk

gs up        # Move to child branch
gs up 2      # Move up 2 branches
gs down      # Move to parent branch
gs top       # Jump to topmost leaf
gs bottom    # Jump to trunk

Inspecting branches

gs info

Show detailed information about the current branch, including parent, children, depth in stack, and path to trunk.

gs info

gs parent

Show the parent branch of the current branch.

gs parent

gs children

Show all child branches of the current branch.

gs children

Workflow: navigating your stack

# View the stack
gs log
 
# Quickly jump to trunk
gs co -t
 
# Interactively select a branch to checkout
gs co
 
# Only see branches in current stack
gs co -s

Navigating Stacks