Blog
Release notes, case studies, and tutorials from the SDF team.
SDF v0.4.0: Worktrees for Parallel Agents
SDF v0.4.0 adds opt-in worktree mode — every branch in a stack becomes its own git worktree, so multiple agents (or humans) can work on different branches at once without stepping on each other. Sync goes pull-model and per-worktree, and the whole stack toolset (branch, sync, merge, move, restack, split, prune, doctor) is worktree-aware.
Anatomy of a Cascade Rebase Bug: When git rebase --onto Gets the Wrong Boundary
How a subtle mismatch between two SHAs in a fast-path optimization caused sdf sync to embed stale parent commits inside downstream branches -- and the detective work to find it.
SDF v0.3.7: Sharper Edges
SDF v0.3.7 adds sdf ls and sdf prune, smarter sync that skips unnecessary rebases, verbose status output, PR template support, better merge error handling, and a batch of reliability fixes.
SDF v0.3.0: Machine-Friendly, Human-First
SDF v0.3.0 adds structured JSON output to every command, smart shell completions, AI-powered onboarding and branch splitting, CI status visibility, and a new event-driven rendering engine.
sdf split: Turn Any Branch into a Stack
sdf split uses Claude to decompose a single large branch into a chain of focused, reviewable PRs -- without touching the original branch.
Testing CLI Tools That Shell Out: From 'Works on My Machine' to Provable Correctness
How we built a testing strategy for a CLI tool that delegates everything to git and gh -- fake binaries, spy recording, cross-validation, and build tags.
SDF v0.2.0: Merge, Fetch, and a Real UI
SDF v0.2.0 adds sdf merge and sdf fetch, drift detection in status, polished terminal output with the Charm ecosystem, and a dozen quality-of-life improvements.
Introducing SDF: Stacked Diffs That Stay in Sync
SDF v0.1.0 is here -- a CLI tool that automates cascade rebasing for GitHub PR stacks, with optional AI-powered conflict resolution.
Case Study: Shipping a Users Feature in Four Stacked PRs
How a team used SDF to decompose a large feature into reviewable layers -- and kept everything in sync as reviews and merges happened out of order.