This cheatsheet provides a concise reference for most mg commands. For detailed information on each command, click the command name to view its dedicated documentation page.

mg only intercepts recognized subcommands. Everything else is passed through to Git, so your normal Git workflow stays intact.

CommandDescription
mg initInitialize mg in your repository and identify your trunk branch.
mg branch <branch_name>Create a new branch on top of the one you’re on.
mg listView your entire stack/tree of branches.
mg checkout <branch>Switch to a different branch.
mg pushPush the current branch (PR) to remote.
mg push --allPush the entire stack to remote.
mg syncSync with remote (rebases and re-stacks if main changed).
mg orphanRemove the current branch from mg’s tree tracking (no deletion in Git).
mg commit -bCommit and auto-generate a new branch name (--branch-name <name> if you prefer).
mg splitInteractive rebase / split a larger commit.
mg adopt <branch>Bring an existing Git branch under mg’s stack tracking.
mg reparent --parent <branch>Change the current branch’s parent.
mg nextMove to the child branch in your stack.
mg prevMove to the parent branch in your stack.
mg helpSee all available mg commands.

If a PR is merged upstream, mg sync automatically re-stacks child branches to the new parent. This doesn’t directly pull from main—so if you want local changes from the remote trunk, run mg sync or do a git pull.

​
Common Workflows

​
Creating a stack

mg branch feature_1
# Make changes
mg add . && mg commit -m "Feature 1 changes"
mg branch feature_2
# Make more changes
mg add . && mg commit -m "Feature 2 changes"
mg push --all

​
Keeping a stack updated

# When main has changed
mg sync

​
Moving between branches in a stack

# Move to parent branch
mg prev

# Move to child branch
mg next

For more detailed information about each command, refer to the individual command pages in the reference section.

Was this page helpful?