{"id":30763491,"url":"https://github.com/gko/gwt","last_synced_at":"2026-04-15T05:32:27.048Z","repository":{"id":309631404,"uuid":"1036837233","full_name":"gko/gwt","owner":"gko","description":"A simple helper script to manage git worktrees using fzf","archived":false,"fork":false,"pushed_at":"2025-12-02T21:40:10.000Z","size":43,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-05T21:52:54.471Z","etag":null,"topics":["bash","cli","developer-tools","fzf","git","git-tools","git-worktree","productivity","shell-script","zsh"],"latest_commit_sha":null,"homepage":"https://zametka.com/@konstantin/git-worktree-manager","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-12T16:51:42.000Z","updated_at":"2025-12-02T21:40:14.000Z","dependencies_parsed_at":"2025-12-04T03:03:55.745Z","dependency_job_id":null,"html_url":"https://github.com/gko/gwt","commit_stats":null,"previous_names":["gko/gwt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gko/gwt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Fgwt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Fgwt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Fgwt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Fgwt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gko","download_url":"https://codeload.github.com/gko/gwt/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gko%2Fgwt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31828531,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","cli","developer-tools","fzf","git","git-tools","git-worktree","productivity","shell-script","zsh"],"created_at":"2025-09-04T16:03:58.946Z","updated_at":"2026-04-15T05:32:27.037Z","avatar_url":"https://github.com/gko.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gwt — A Git Worktree Manager\n\n\u003cdiv align=\"center\"\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/c436a2a4-c108-4b62-a84c-66b1545db931\"\u003e\u003c/video\u003e\n\u003c/div\u003e\n\n`gwt` is a simple command-line tool to help you manage your Git worktrees with ease. It simplifies the process of creating, navigating, and removing worktrees.\n\nYou can read more about `git worktree` here: https://dev.to/konstantin/checking-out-multiple-branches-at-the-same-time-in-git-and-moving-files-between-them-31hk\n\n## Features\n\n* **Interactive Navigation**: Quickly jump between worktrees using an fzf-powered menu. \n* **Quick Add**: Create a new worktree from an existing branch and switch to it in one command. If the branch doesn't exist, it will offer to create it.\n* **Easy Removal**: Interactively select and remove worktrees. \n* **Direct Access**: Jump directly to a worktree for a specific branch. \n* **Main Branch Shortcut**: Instantly navigate to the worktree of your repository's default branch (main or master). \n* **Zsh Completion**: Tab completion for commands and branch names in Zsh.\n\n## Installation\n\nYou will need to install [fzf](https://github.com/junegunn/fzf) (see these [installation instructions](https://github.com/junegunn/fzf?tab=readme-ov-file#installation)) for the interactive features.\n\n### Quick Start (One-liner)\n\nRun this to download `gwt` and add it to your shell configuration:\n\n```shell\ncurl -sLo ~/.gwt.sh https://raw.githubusercontent.com/gko/gwt/master/gwt.sh\necho 'source ~/.gwt.sh' \u003e\u003e ~/.zshrc # or ~/.bashrc\n```\n\nFor Zsh users, you can also install the completion script:\n\n```shell\nmkdir -p ~/.zsh/completions\ncurl -sLo ~/.zsh/completions/_gwt https://raw.githubusercontent.com/gko/gwt/master/_gwt.zsh_completion\n```\n\n### With [zinit](https://github.com/zdharma-continuum/zinit)\n\nIn your `.zshrc`:\n```shell\nzinit light gko/gwt\n```\n\n### With [antigen](https://github.com/zsh-users/antigen)\n\nIn your `.zshrc`:\n```shell\nantigen bundle gko/gwt\n```\n\n### Manual\n\n1. Clone this repository or download the gwt.sh script. \n```shell\ngit clone https://github.com/gko/gwt.git\n```\n\n2. Source the gwt.sh script in your shell's configuration file (e.g., `~/.bashrc`, `~/.zshrc`). Add the following line: \n```shell\n# Make sure to use the correct path to where you cloned the repo \nsource /path/to/gwt/gwt.sh\n```\n\n3. Restart your shell or source the configuration file for the changes to take effect: \n```shell\nsource ~/.zshrc \n```\nor \n```shell\nsource ~/.bashrc\n```\n\n#### Zsh Completion\n\nFor Zsh users, gwt comes with a completion script for commands and branch names.\n\n1. Make sure the `_gwt.zsh_completion` file is in a directory that is part of your Zsh `fpath`. You can check your `fpath` with echo `$fpath`. A common location is a custom completions directory like `~/.zsh/completions`. \n2. If you don't have a custom completions directory, you can create one and add it to your `~/.zshrc`: \n```shell\nmkdir -p ~/.zsh/completions  \n# Add this to your .zshrc, before the line that sources oh-my-zsh if you use it  \nfpath=($HOME/.zsh/completions $fpath)\n```\n\n3. Copy or symlink the `_gwt.zsh_completion` file into that directory. \n```shell\n# Rename it to '_gwt' so Zsh can find it \ncp /path/to/gwt/_gwt.zsh_completion ~/.zsh/completions/_gwt\n```\n\n4. Restart your shell. You should now have tab completion for gwt commands.\n\n## Usage\n\n```\nUsage: gwt [command]\nExample:\n  gwt               interactively choose a worktree and cd into it\n  gwt add \u003cbranch\u003e  create a new worktree for \u003cbranch\u003e and cd into it\n  gwt main          jump to default branch worktree (or repo root)\n  gwt master        alias of 'gwt main'\n  gwt \u003cbranch\u003e      jump to the worktree for \u003cbranch\u003e\n  gwt remove [-f|--force]\n                     interactively remove a worktree (force removal with -f)\nOptions:\n  -h, --help        show this help\n```\n\n## License\n\nThis project is open source and available under the [GPLv3](/LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgko%2Fgwt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgko%2Fgwt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgko%2Fgwt/lists"}