Git Worktrees
CrispyVibe understands git worktrees. When projects in a VibeSpace are worktrees of the same repository, they’re grouped under one repository in the Workspace side panel, and you can open, create, close, and delete worktrees right from there.
Getting started
- Open the Workspace rail item (the grid icon in the side menu). It’s on by default.
- A repository with more than one worktree appears as a collapsible repository row — for example,
myrepo · 2 worktrees. - Expand it to see each worktree, labeled by branch, each with its own Files, Changes, and Chats.
Open a worktree that isn’t added
Expand the repository, open Other worktrees (N), and click Open (or right-click → Open as Project). The worktree moves up into the repository as a full member.
Create a new worktree
Click the + on the repository row and choose New Worktree…, then enter a branch name. CrispyVibe creates a sibling worktree on that branch and opens it.
Close a worktree
Right-click a worktree and choose Close Worktree. It’s removed from the sidebar but stays on disk, reappearing under Other worktrees. Nothing is deleted.
Delete a worktree
Right-click a worktree, choose Delete Worktree…, and confirm. This removes the directory from disk and unregisters it from git.
If the worktree has uncommitted changes, git refuses the delete — you can then choose Force Delete, which discards those changes. The repository’s main worktree can’t be deleted.
Subdirectories stay standalone
Only folders opened at a worktree’s root are grouped as worktrees. A subdirectory you opened as its own project stays a standalone node, even when it lives inside the same repository — it’s no longer mis-grouped under that repo.
Troubleshooting
| Issue | Resolution |
|---|---|
| A worktree isn’t showing | It must belong to a git repo you’ve added. Non-git folders and SSH/remote projects aren’t grouped. |
| Delete failed | The worktree likely has uncommitted changes or is locked. Use Force Delete only if you accept losing those changes. |
| ”Other worktrees” is empty | The repo has only the worktrees you’ve already added. |
| A folder inside a repo shows as its own project | Expected — only folders opened at a worktree root are grouped. A subdirectory opened as its own project stays standalone. |
Known limitations
- Local repositories only — no SSH or remote worktrees yet.
- Branch-name validation is minimal; use normal git branch names.
- No agent-CLI commands for worktrees yet.