Skip to content

Worktrees

Git worktrees let one repository have several branches checked out in separate folders. luvus makes them first-class workspaces.

  • Ctrl+Space G: type a branch name, and luvus runs git worktree add under ~/.luvus/worktrees/<repo>/<branch> and opens it as a workspace.
  • The folder picker (Ctrl+Space N): when browsing a git repo, an Open with new worktree row (or the w key) does the same for that repo.
  • CLI: luvus worktree create <branch> · open <path> · list · remove <path> (the branch is kept).

Each agent works in its own worktree, with its own files on disk, so two agents can work the same repo without any chance of stepping on each other’s edits. The sidebar nests worktrees under their repo, so the grouping is always visible. This is also the foundation the orchestration board builds on.