This wrapper script features an API for git-worktree commands
in order to easily create, switch and delete worktrees of bare repositories
using commands you already know: git checkout and git branch.
Quiet built-in checkouts are made after each overridden checkout to trigger post-checkout hooks.
Clone this repository
git clone https://github.com/lu0/git-worktree-wrapper
cd git-worktree-wrapperLink git-wrapper-script to your local PATH
ln -srf git-worktree-wrapper.sh ~/.local/bin/git-worktree-wrapperAdd the following to your ~/.bashrc or ~/.bash_aliases
alias git="source git-worktree-wrapper"Restart your terminal or re-run bash
bashCheck if your current completion rules autocomplete git after installing
the wrapper script. Try git checko + TAB
If your git commands are no longer autocompleted, install complete_alias@3fc67e8.
sudo apt install bash-completion
git clone https://github.com/cykerway/complete-alias ~/.complete-alias
cd ~/.complete-alias
git checkout 3fc67e8
echo ". ${PWD}/complete_alias" >> ~/.bash_completionInherit git's completion rules by pasting the following in your ~/.bashrc or
~/.bash_aliases
alias git="source git-worktree-wrapper"
complete -F _complete_alias git
__compal__get_alias_body() {
local cmd="$1"
local body; body="$(alias "$cmd")"
# Overrides
case "$cmd" in
"git") body="git"
esac
echo "${body#*=}" | command xargs
}Set the environment variable EDITOR in your ~/.bashrc,
git-worktree-wrapper will try to open worktree directories using this editor.
# Example using vscode
export EDITOR=codeOr set DISABLE_GIT_WORKTREE_EDITOR=1 to disable usage of editors.
export DISABLE_GIT_WORKTREE_EDITOR=1Try with this repo!
git clone --bare https://github.com/lu0/git-worktree-wrapper
cd git-worktree-wrapper.gitgit config --local remote.origin.fetch +refs/heads/*:refs/remotes/origin/*
git fetchSwitch to branch master:
git checkout masterYou can also switch to an existing tag:
git checkout v1.0.0The script will automatically create the worktree, if it does not exist, and cd into it, even if you are cd'd into another worktree/branch/tag:
Next commands should be issued to achieve the same functionality described above when
git-worktree-wrapper is not installed:
If the branch/tag exists but the worktree doesn't.
cd /path/to/the/root/of/the/bare/repository
git worktree add master
cd master
When the worktree exists:
cd /path/to/the/root/of/the/bare/repository
cd masterTo create a new branch, just issue the command you already know:
git checkout -b new_branch <from_branch (optional)>
# or use -B to force resetThe script will automatically create a new worktree and cd into it, even if you are cd'd into another worktree/branch/tag:
Next commands should be issued to achieve the same functionality described above when
git-worktree-wrapper is not installed:
When both the branch and worktree don't exist
git branch new_branch
cd /path/to/the/root/of/the/bare/repository
git worktree add new_branch
cd new_branch
When branch or worktree already exist and you want to reset it as
git checkout -B would do:
cd /path/to/the/root/of/the/bare/repository
cd new_branch
git checkout -B new_branch <from_branch (optional)>To delete a branch, just issue the command you already use for "normal" repositories:
git branch -d new_branch # or -D to force removalThe script will delete both the branch and its worktree.
If you are cd'd into the worktree/branch you are deleting, the script will cd you into the root directory of the bare repository.
Next commands should be issued to achieve the same functionality described above when
git-worktree-wrapper is not installed:
cd /path/to/the/root/of/the/bare/repository
git worktree remove new_branch
git branch -d new_branch # or -D to force removal
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent