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)

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