Command Overview

Quick reference for all rung commands. Click any command for detailed documentation.

Global Options

These options work with most commands:

Option	Description
--json	Output as JSON (for tooling integration)
-q, --quiet	Suppress informational output
--help	Show help for any command
--version	Show rung version

Commands

Command	Alias	Description
init		Initialize rung in a repository
adopt	ad	Adopt existing branch into the stack
create	c	Create a new branch in the stack
status	st	Display stack tree and PR status
sync	sy	Rebase all branches when parents move
submit	sm	Push branches and create/update PRs
merge	m	Merge PR and update the stack
restack	re	Move branch to different parent
split	sp	Split branch into multiple branches
fold	fo	Combine adjacent branches into one
nxt	n	Navigate to child branch
prv	p	Navigate to parent branch
move	mv	Interactive branch picker
log		Show commits on current branch
absorb	ab	Absorb staged changes into commits
undo	un	Restore stack to pre-sync state
doctor	doc	Diagnose stack and repo issues
update	up	Update rung to the latest version
completions	comp	Generate shell completions

Quick Reference

Starting a Stack

rung init                            # Initialize rung
rung create feature/auth             # Create named branch
rung create -m "feat: add auth"      # Create from commit message
rung adopt existing-branch           # Bring existing branch into stack

Working with Stacks

rung status                          # View stack tree (or: rung st)
rung sync                            # Rebase all branches (or: rung sy)
rung submit                          # Push and create PRs (or: rung sm)

Navigation

rung nxt                             # Go to child branch
rung prv                             # Go to parent branch
rung move                            # Interactive picker
rung log                             # Show branch commits

Merging

rung merge                           # Squash merge (default)
rung merge --method merge            # Regular merge
rung merge --method rebase           # Rebase merge

Restacking

rung restack --onto main             # Move current branch onto main
rung restack feat/api --onto main    # Move specific branch
rung restack --onto main --include-children  # Also move descendants

Absorbing Changes

git add -p                           # Stage changes selectively
rung absorb --dry-run                # Preview what would be absorbed
rung absorb                          # Create fixup commits
git rebase -i --autosquash main      # Apply the fixups

Splitting Branches

rung split                           # Split current branch interactively
rung split feat/big-change           # Split specific branch
rung split --dry-run                 # Preview without changes
rung split --abort                   # Abort and restore

Folding Branches

rung fold                            # Interactive fold selection
rung fold --into-parent              # Fold current into parent
rung fold --include-children         # Fold children into current
rung fold --dry-run                  # Preview without changes

Recovery

rung undo                            # Restore from last sync
rung sync --abort                    # Abort in-progress sync
rung doctor                          # Diagnose issues