Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gx.mubbie.dev/llms.txt

Use this file to discover all available pages before exploring further.

gx switch provides an interactive branch picker with search filtering, sorted by most recently committed. Each branch shows its age and author for quick context.

​
Usage

gx switch [- | branch]

​
Arguments

ArgumentDescription
-Switch to the previous branch (like git switch -)
branchSwitch directly to a named branch
(none)Open the interactive picker

​
Interactive Picker

When run without arguments, gx lists all branches (excluding the current one) sorted by most recent commit: 
    1  feature/auth           5 minutes ago   Kim
    2  feature/dashboard      2 hours ago     James
    3  fix/login-redirect     3 days ago      Kim
    4  chore/deps             1 week ago      Alex

Enter a number to switch, text to filter, q to cancel
  • Enter a number to switch to that branch
  • Type text to filter branches by name (case-insensitive substring match)
  • Enter q or press Enter with no input to cancel
If there is only one other branch, gx switches to it automatically without showing the picker.

​
Quick Switch

The - shortcut switches to the previous branch, just like git switch -: 
$ gx switch -
OK Switched to feature/auth

​
Examples

# Interactive picker
$ gx switch

# Switch to previous branch
$ gx switch -

# Direct switch (no picker)
$ gx switch feature/auth
If you have uncommitted changes, gx prints a warning before showing the picker: WARN You have uncommitted changes. They may conflict with the target branch.
  • If there are no other branches, gx prints > No other branches to switch to.
  • Branch names longer than 45 characters are truncated with ... in the picker display
  • The picker supports repeated filtering — entering new text replaces the previous filter
  • If gx switch - has no previous branch (new repo), gx prints ERROR No previous branch to switch to.