| 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
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
- Start from trunk:
git checkout main && git pull
- Create layers with
dub create ... -am ...
- Inspect stack with
dub log
- Submit with
dub ss
- Iterate with
dub m ... and dub ss
- Keep updated with
dub sync (or dub restack when needed)
Recovery Patterns
Restack conflict
git add <resolved-files>
dub restack --continue
Undo mistaken create/restack
dub undo
Branch not tracked
dub track <branch> --parent <parent>
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
