Worktrees and branches
At the top of a Git repository's folder page there's a button showing the current worktree and branch. Click it to see all of this repository's worktrees: click one and the sidebar switches to that worktree; on the current worktree's row, go into Branches to change its branch. Switching worktrees and branches is a Plus feature. Without Plus you can still see the list, but clicking another worktree or branch opens the subscription window.
What a worktree is
Section titled “What a worktree is”Worktrees are a Git feature: the same repository checked out into several folders at once, each folder on its own branch. Many AI tools open a worktree for each task, so several tasks can run at the same time without getting in each other's way. Resomark treats the worktrees of one repository as one family, so you don't have to add each one as a Workspace.
Switch worktrees
Section titled “Switch worktrees”- Click the worktree button at the top of the folder page; the repository's worktree list pops up.
- Each row is a worktree, with its branch name and change colors, so you can see at a glance which ones have changes. You can search the list (Search Worktrees or Branches).
- Click one and the sidebar switches to that worktree's folder page.
Switching only changes the sidebar on the left: the files open on the right, your tabs and anything unsaved stay as they are. Worktrees created by other tools appear the next time the list refreshes. Switching on a Pinned Folder's page takes you to the folder at the same place in the other worktree.
Favorites and Pinned Folders are shared across all worktrees of the same repository.
Change branches
Section titled “Change branches”- On the current worktree's row in the list, click the branch button to go into Branches.
- The list is split into Local Branches and Remote Branches, and you can search it.
- Click a branch to switch to it. Only the current worktree switches.
So that nothing gets lost, switching isn't allowed in these cases, and you're told why:
- There are uncommitted changes: "Commit or discard working tree changes before switching branches."
- There are unsaved documents: "Save open documents before switching branches."
- Git is in the middle of another operation (a merge, for example).
- The branch is already checked out in another worktree (Git itself doesn't allow this).
Resomark never stashes, commits or discards changes for you.
Refresh and delete
Section titled “Refresh and delete”- Refresh at the top of the list only updates the information about remote branches; it doesn't pull or push.
- You can delete a worktree you no longer need with the trash button on its row: that deletes its folder and keeps the branch. A worktree that has changes, untracked or ignored files, or a lock, or that's open, can't be deleted.