Bare Repo Worktrees: Based on what branch is the new branch created?

[Clindbergh]

When specifying the repo path as /.bare based on what branch is a new branch created?

[asheshgoplani]

Good question, and worth a docs note. Behavior comes from internal/git/git.go::resolveWorktreeBranch plus the underlying git worktree add semantics. For your bare-repo case:

1. If the branch name you give already exists locally in the bare repo: it's reused. The worktree checks out that branch's existing tip.
2. If it doesn't exist locally but exists on the default remote (e.g. origin/feat/foo): tracked from the remote. Worktree starts at the remote tip.
3. If it doesn't exist anywhere: a new branch is created — and this is the bit you're asking about — branched from HEAD in the bare repo. In a bare repo, HEAD is whatever ref <repo>.bare/HEAD points at. Usually refs/heads/main (or master) since that's what git clone --bare sets by default. You can check yours with:

cat /path/to/repo.bare/HEAD

or:

git -C /path/to/repo.bare symbolic-ref HEAD

Whatever that prints is the base. To change it: git -C /path/to/repo.bare symbolic-ref HEAD refs/heads/develop (or whatever).

Will add this to docs/CONDUCTOR.md or the worktree docs section in the next docs PR.