Concepts

Six short pages covering the mental model sm is built on. Read these once and the command surface should make sense in context.

• Stacks — what a stack is and why dependent PRs.
• Trunk — auto-detection, override, the role of trunk in every command.
• Restack — what gets rewritten when a parent moves, when the engine pauses, how to resume.
• Sync — pulling latest, pruning merged branches, retargeting survivors.
• Parent metadata — where stack relationships live and what sm doctor validates.
• Cockpit — the interactive TUI that bare sm opens on a TTY.

If you only have time for one page, start with Stacks.