DubStack CLI

Key Concepts

Stack: Chain of dependent branches (e.g.,
```
main
```
->
```
feat/a
```
->
```
feat/b
```
)
Root: The base branch (usually
```
main
```
)
Restacking: Rebasing branches onto their updated parents (e.g., after parent changes)
Submit: Pushing branches and creating/updating GitHub PRs for the entire stack

Install:

npm install -g dubstack

brew install wiseiodev/dubstack/dubstack

Auth: ensure
```
gh auth login
```
is done (DubStack uses
```
gh
```
CLI for PRs)
Init: Auto-initialized on first
```
dub create
```
(or run
```
dub init
```
)

Create branch & commit:
```
dub create <name> -am "<msg>"
```
Create branch only:
```
dub create <name>
```
(then git add/commit manually)

Modify current branch: standard git workflow (
```
git add
```
,
```
git commit
```
)

Modify current branch: standard git workflow (
```
git add
```
,
```
git commit
```
)
Update parent branch:
```
dub co <parent>
```
, modify, commit
Propagate parent changes to children:
```
dub restack
```
Propagate parent changes to children:
```
dub restack
```

Command	Description
`dub create <name> -am "msg"`	Create branch, stage all, commit (like `gt create` )
`dub log`	Show ASCII tree of current stack
`dub checkout`	Interactive branch picker (alias `dub co` )
`dub ss`	Push branches & create/update PRs (alias for `dub submit` )
`dub restack`	Rebase all branches in stack onto their parents
`dub undo`	Undo last `create` or `restack` operation
`dub init`	Manually initialize DubStack (optional)

Problem	Solution
"Not authenticated"	Run `gh auth login`
"Branch name exists"	Choose different name
"Conflict during restack"	Resolve files, `git add` , `git rebase --continue`
"Need to sync with main"	`git checkout main && git pull` , then `dub restack`
"Accidentally modified wrong branch"	`dub undo` if created via dub, or standard git undo

See

QUICKSTART.md

in the repo root for a complete walkthrough.