dubstack

name	dubstack
description	Use when managing stacked branch workflows with DubStack, including create/modify, navigation, sync/restack, submit, PR opening, and recovery.

DubStack CLI Skill

Use this skill whenever the user is working in a repo that uses dub for stacked diffs.

Core Concepts

• Stack: A chain of dependent branches (main -> feat/a -> feat/b)
• Root: Trunk branch for a stack (commonly main)
• Restack: Rebase branches so each child is based on its updated parent
• Submit: Push stack branches and create/update PRs

Fast Command Map

Intent	Command
Create branch	dub create <name>
Create + commit	dub create <name> -am "msg"
Modify current branch	dub modify / dub m
Navigate stack	dub up, dub down, dub top, dub bottom
Interactive checkout	dub checkout / dub co
View stack	dub log / dub ls
View current stack only	dub log --stack
Sync with remote	dub sync
Rebase stack	dub restack
Continue interrupted op	dub continue
Abort interrupted op	dub abort
Track/re-parent branch	dub track [branch] --parent <branch>
Untrack metadata only	dub untrack [branch] [--downstack]
Stack-aware delete	`dub delete [branch] [--upstack
Show parent/children/trunk	dub parent, dub children, dub trunk
Submit PR stack	dub submit / dub ss
Open PR in browser	`dub pr [branch
Undo last create/restack	dub undo

Command Notes

Create

dub create feat/x
dub create feat/x -m "feat: ..."
dub create feat/x -am "feat: ..."
dub create feat/x -um "feat: ..."
dub create feat/x -pm "feat: ..."

• -a: stage all
• -u: stage tracked-file updates
• -p: interactive hunk staging
• staging flags require -m

Modify

dub m
dub m -c -m "fix: ..."
dub m -p
dub m -u
dub m -v
dub m -vv
dub m --interactive-rebase

• Restacks descendants after modification.
• -m can be passed multiple times.
• -v prints staged diff, -vv also prints unstaged diff.

Checkout and Navigation

dub co
# or
dub checkout --stack
dub checkout --show-untracked
dub checkout --trunk

dub up
dub up 2
dub down
dub down --steps 2
dub top
dub bottom

Sync, Restack, Submit, PR

dub sync
dub sync --all
dub sync --no-interactive
dub sync --force
dub sync --no-restack

dub restack
dub restack --continue
dub continue
dub abort

dub ss
dub submit --dry-run

dub pr
dub pr feat/a
dub pr 123

Track, Untrack, Delete

dub track
dub track feat/a --parent main

dub untrack feat/a
dub untrack feat/a --downstack

dub delete feat/a
dub delete feat/a --upstack
dub delete feat/a --downstack
dub delete feat/a --force --quiet

Orientation

dub parent
dub children
dub trunk

Recommended Workflow

1. Start from trunk: git checkout main && git pull
2. Create layers with dub create ... -am ...
3. Inspect stack with dub log
4. Submit with dub ss
5. Iterate with dub m ... and dub ss
6. Keep updated with dub sync (or dub restack when needed)

Recovery Patterns

Restack conflict

# after conflict
git add <resolved-files>
dub restack --continue

Undo mistaken create/restack

dub undo

Branch not tracked

• Track branch explicitly:

dub track <branch> --parent <parent>

• Verify placement:

dub parent <branch>
dub trunk <branch>

Common Errors

Symptom	Action
gh CLI not found	Install gh
Not authenticated with GitHub	gh auth login
branch missing from stack	Use dub create from tracked context
sync skips branches	rerun with interactive mode or --force if appropriate

References

• Command Reference
• Workflow Reference