https://github.com/benjamin-carpene/git-switch-worktree

A powerful git switch alternative for worktrees
https://github.com/benjamin-carpene/git-switch-worktree

bash git script switch worktree zsh

Last synced: 17 days ago
JSON representation

A powerful git switch alternative for worktrees

• Host: GitHub
• URL: https://github.com/benjamin-carpene/git-switch-worktree
• Owner: benjamin-carpene
• License: mit
• Created: 2024-11-07T23:23:36.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-05T22:18:57.000Z (17 days ago)
• Last Synced: 2024-12-05T23:17:46.691Z (17 days ago)
• Topics: bash, git, script, switch, worktree, zsh
• Language: Shell
• Homepage:
• Size: 10.7 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Description

Git Switch Worktree (GSW) is a simple yet powerfull git utility used for navigating between git worktrees.

It enables the user to navigate in worktrees using `gsw` in the same way as they would use `git switch` in a bare repository.

# Features

- Navigate through worktree directories for a given repository

- Still works like a charm on bare repo

- Uses FZF's TUI for choosing a worktree wen no argument given

- Has a 'last worktree' feature (`gsw -`) for switching to the last worktree

    - Works on a **PER REPOSITORY** basis, to not mix oranges and apples

    - You can still use `gsw --` if you want to use the default `git switch -` option

- Is a lightweight bash function, that can be simply copy-pasted or sourced in your rc file

- Works on bash and zsh

# Synopsis

`gsw [BRANCH]`

- With `[BRANCH]` the optional argument branch that we will switch to

- If no branch is given, FZF's TUI is used for the user to choose his branch

- If the branch is a worktree, `gsw` switches to it (goes to the right directory)

- If the selected branch is not a worktree, `gsw` simply switches to it as a regular `git switch` command

# Dependencies

- `git` (obviously)

- `fzf` for the TUI

- A `bash` or/and `zsh` interpreter

- That's all 😀

# Installation

Run the `./install.sh` script on this repo, which installs the script in `~/.local/share`.

*Nota : It comes with its own alias named after himself, if **like me** you already had a `gsw` alias for git switch.*