finds.dev← search

// the find

ThePrimeagen/git-worktree.nvim

★ 889 · Lua · updated Aug 2024

A Neovim plugin that wraps git worktree commands (create, switch, delete) and surfaces them through Telescope. Aimed at developers who work across multiple branches simultaneously and want to stay inside their editor rather than context-switch to a terminal.

The hook system is the standout feature — emitting typed events for create/switch/delete lets you chain other plugins (harpoon, LSP restarts, tmux pane switches) without patching the plugin itself. Telescope integration is well-thought-out: the branch picker feeds directly into worktree creation, so you're not typing branch names twice. Logging is configurable via both a vim global and an environment variable, which makes debugging CI or unusual git setups less painful. The bare-repo workflow is explicitly documented and the plugin is built around it, which is the right call for worktree-heavy usage.

Last commit was August 2024 and the README's Known Issues section links to GitHub rather than listing them — that's a sign maintenance is inconsistent. The `autopush` option silently does a `git push` plus a `git rebase` on worktree creation, which is an unusual combination that will surprise anyone whose workflow doesn't expect it. The Telescope create flow can't specify an upstream, so if your remote branch name differs from local or you're on a fork, you'll need to fix it manually after. Under 900 stars for a plugin by ThePrimeagen is a tell that the native Neovim ecosystem has mostly moved to more actively maintained forks.

View on GitHub →

// want more like this?

We dig through GitHub every week and send a few repos picked for what you actually care about — each with an honest take like this one.

Get finds in your inbox → Search again →