On this page
Why move a folder
A Git repository does not belong in a folder that syncs: iCloud Drive, Desktop & Documents, Dropbox, or Google Drive. Syncing makes conflict copies inside the repository and can leave parts of it only in the cloud. brunvo doctor warns when an open project sits in such a folder. A plain folder such as ~/Developer is a good home.
Move it in Brunvo
In the sidebar, open the menu of a project, repository, or worktree and choose Move Folder…. An Agent Mode project with a folder of its own has it in the project's menu.
- Choose where it goes. Brunvo offers
~/Developerfor a folder that syncs. - Read what the sheet says: what moves, what keeps running, and anything in the way, with what to do about it.
- Choose Move. The sheet shows each step.
Worktrees beside the folder go with it unless you turn that off. A worktree anywhere else stays where it is, with its Git links repaired.
What follows the folder
- Your projects, tabs, and sessions, including ones that ended.
- Parked agents, Agent Mode chats, and Git's worktree links.
- Claude Code's and Grok's conversations, and the trust Claude Code and Codex gave the folder.
Linked issues and measured hours hold no paths, so they are not touched.
Agents and programs
An agent at its prompt keeps running: its process follows the folder, and a link stays at the old path for the paths it remembers. An agent in the middle of a turn is never interrupted: Brunvo waits for the turn to end, and you can stop waiting.
A move does not start while a Git operation is in progress, a program other than a shell runs in the folder, a resource is held for a session there, or a local stack serves it. The sheet names each one and what to do.
iCloud and other disks
Files that are only in the cloud download first. A move with any left is refused and names them. A move out of a folder that syncs puts the conflict copies iCloud made in the Trash as one item, so you can put them back.
On the same disk a move is instant. To another disk Brunvo copies the folder, checks every item and size, and runs git fsck before it swaps. The original stays beside its old place as NAME.brunvo-moved-TIME until you remove it. Close any agents in the folder first: a running program would stay in the original.
From the command line
brunvo relocate --from ~/Documents/GitHub/site --to ~/Developer/site --family --preview
brunvo relocate --from ~/Documents/GitHub/site --to ~/Developer/site --family --apply
--preview changes nothing. --family takes the worktrees beside the folder. --compat-link leaves a link at the old path. Moving it back undoes it.