FAQ

Questions, answered.

Everything people ask before they install stkd — the basics of stacked diffs, the day-to-day workflow, team and self-hosting concerns, and how migration from Graphite works.

The basics

Stacked diffs are a code-review pattern where you split a large change into a chain of small, dependent branches — each opened as its own pull request. Reviewers approve one PR at a time, you keep coding on top of the stack, and tools like stkd automatically rebase the dependent branches whenever an earlier one changes or lands.

Workflow

From any branch you run gt create to start a new branch tracked as a child of the current one. Commit, then gt create again to stack another change on top. gt log shows the whole stack, and gt submit --stack opens or updates every PR in the chain in one command.

Teams & self-hosting

No. stkd opens ordinary GitHub pull requests and GitLab merge requests with a cross-linked 'Stacked PRs' comment. Reviewers use the normal web UI. Only the author driving the stack needs stkd installed.

Migration & compatibility

Run gt repo init in the repo. stkd reads the same branch..parent git-config metadata Graphite already stores, so your existing stacks are recognised immediately — no re-tracking and no retraining, since the gt command grammar matches.

Ready to stack your next change?

Install stkd in under a minute. Apache-2.0, single binary, every major platform.