Repository navigation
Worktrees
A worktree is a Git checkout of one branch in its own folder, <project>-worktrees/<branch> next to the project. A / in the branch name becomes -. Skiff shows a row for each worktree when a project has more than a bare worktree. See the Glossary.
A plain folder project has no Git, so it has no worktrees. New worktree… does not show, and Ctrl+Shift+N does nothing.
- In the project menu, select New worktree… (Ctrl+Shift+N).
- Type a new branch name, or pick a branch under Branches without a worktree. A branch that is only on a remote shows by its short name.
- For a new branch, select its start in From. The list shows the local and remote branches, newest first. It starts on the branch of the project folder, or on HEAD when HEAD is detached.
- Select Create.
When the name is a listed branch, From hides. Git checks out that branch in place of a new one.
The same dialog works on a Host. A Host with an older Skiff shows only the name field. See Hosts.
In the worktree row's menu, select Remove worktree… and confirm. The branch stays. The main worktree has no such item. Skiff refuses while a session runs in the worktree. If the worktree has uncommitted changes, a second dialog asks, and Remove anyway deletes them. The same menu has Review all changes when the worktree has changes.