# troubleshooting

## `/branchout` says the source diverged

`/branchout` uses `git pull --ff-only origin <source>`. update the source branch manually, resolve divergence, then rerun.

## repository has no `origin`

`/branchout` fetches and pulls from `origin`. add an origin remote or use git manually.

## branch already exists

`git checkout -b <new> <source>` fails when `<new>` already exists. choose a different branch name or check out the existing branch manually.

## dirty worktree prevents checkout

git refuses checkouts that would overwrite local changes. commit, move, or stash those edits yourself; branchout will not do that for you.

## detached HEAD

`/branchout` lists local branches as source candidates. create or check out a branch manually if your detached state is unusual.

## picker cancelled

escape cancels. cancellation is non-mutating.