Git Worktree Manager

Description

The git-worktree skill manages repositories using a specific directory structure optimized for multi-tasking. Instead of a single .git folder with one working directory, it uses a “bare” clone (or similar) and creates a separate directory for each branch/feature.

Available Scripts

clone_repo

Clones a repository into the current workspace, setting it up for worktree usage. This creates a directory structure where the main repo is stored, and worktrees can be added alongside it.

• Usage: brn git-worktree clone_repo <repo_url> [name]
• Arguments:
  • repo_url: The URL of the git repository to clone.
  • name (optional): The name of the directory to create. Defaults to the repo name from the URL.
• Example: brn git-worktree clone_repo https://github.com/myorg/api.git

create_worktree

Creates a new worktree for a specific branch. If the branch doesn’t exist, it can be created from a base branch.

• Usage: brn git-worktree create_worktree <repo_name> <branch_name> [base_branch]
• Arguments:
  • repo_name: The name of the repository (must be already cloned via clone_repo).
  • branch_name: The name of the new branch and worktree directory.
  • base_branch (optional): The branch to split from. Defaults to main or master.
• Example: brn git-worktree create_worktree api feature/login

list_worktrees

Lists all active worktrees for a repository.

• Usage: brn git-worktree list_worktrees <repo_name>
• Arguments:
  • repo_name: The name of the repository to list worktrees for.
• Example: brn git-worktree list_worktrees api

remove_worktree

Removes a worktree and its directory. This cleans up the working directory and the git worktree entry.

• Usage: brn git-worktree remove_worktree <repo_name> <branch_name>
• Arguments:
  • repo_name: The name of the repository.
  • branch_name: The name of the worktree/branch to remove.
• Example: brn git-worktree remove_worktree api feature/login