g2g

Structure without Graphite — a branch forest recorded in git's common directory; neither Graphite nor GitHub is required

A forest, not a chain — each branch has at most one parent, a parent may have many children, and a repo may have several roots

Preview first, always — every mutating command renders a plan and requires --apply; it re-discovers and revalidates before mutating

Fails closed on ambiguity — track never picks a parent when the answer is unclear, and two open PRs on one branch refuses rather than guessing

Never guesses a trunk from its name — multiple declared trunks on an ancestry demand an explicit --trunk that must be a real ancestor

Graphite as an optional source — import a described stack, mirror local structure back, or pin --from graphite per command

Projects a linear path onto GitHub native stacks — link prints and validates the exact gh stack link command

Atomic, lease-protected push — every selected ref advances together or none of them do

Separate discovery and mutation budgets — a slow read can never cancel a push or PR creation halfway

Blocked previews name the repair — gt sync, g2g submit or g2g link, depending on why the state is stale

Copyable output by design — nothing but whitespace shares a command's line, and PR numbers are OSC 8 hyperlinks where supported

Deterministic for scripts — color off for pipes, CI, NO_COLOR and TERM=dumb; --json and --porcelain never emit links

Tests use fake executables on PATH — no authentication and no network required