Skip to content

Command Overview

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

Global Options

These options work with most commands:

OptionDescription
--jsonOutput as JSON (for tooling integration)
-q, --quietSuppress informational output
--helpShow help for any command
--versionShow rung version

Commands

CommandAliasDescription
initInitialize rung in a repository
createcCreate a new branch in the stack
statusstDisplay stack tree and PR status
syncsyRebase all branches when parents move
submitsmPush branches and create/update PRs
mergemMerge PR and update the stack
nxtnNavigate to child branch
prvpNavigate to parent branch
movemvInteractive branch picker
logShow commits on current branch
absorbabAbsorb staged changes into commits
undounRestore stack to pre-sync state
doctordocDiagnose stack and repo issues
updateupUpdate rung to the latest version
completionscompGenerate shell completions

Quick Reference

Starting a Stack

Terminal window
rung init # Initialize rung
rung create feature/auth # Create named branch
rung create -m "feat: add auth" # Create from commit message

Working with Stacks

Terminal window
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)
Terminal window
rung nxt # Go to child branch
rung prv # Go to parent branch
rung move # Interactive picker
rung log # Show branch commits

Merging

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

Absorbing Changes

Terminal window
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

Recovery

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