21.8K ·GitHub
What is this?
Fugitive is a Git wrapper that lives inside Vim — the README bills it as 'the premier Vim plugin for Git'. The name comes from its own tagline: a Git wrapper 'so awesome, it should be illegal'.
Fugitive is a Git wrapper that lives inside Vim — the README bills it as 'the premier Vim plugin for Git'. The name comes from its own tagline: a Git wrapper 'so awesome, it should be illegal'.So is it a plugin inside my Vim, or a separate tool I run next to Git?It's a plugin written in Vim Script that loads into your editor and adds : commands like :Git — no separate binary or service. It always operates on the repository of the buffer you're in.
It's a plugin written in Vim Script that loads into your editor and adds : commands like :Git — no separate binary or service. It always operates on the repository of the buffer you're in.Do I need anything besides Vim to use it?Just Vim and a Git repo — it works wherever Vim does and always targets the repository of the current buffer. Since :Git mirrors the git CLI, knowing command-line Git is the real prerequisite.
Just Vim and a Git repo — it works wherever Vim does and always targets the repository of the current buffer. Since :Git mirrors the git CLI, knowing command-line Git is the real prerequisite.Does everything from Git work through it, or are there gaps?A couple: symlinks that Git itself won't handle are unsupported, and the old dispatch.vim-backed async :Gpush/:Gfetch was removed — :Git! push or pressing CTRL-D gives you async instead.
A couple: symlinks that Git itself won't handle are unsupported, and the old dispatch.vim-backed async :Gpush/:Gfetch was removed — :Git! push or pressing CTRL-D gives you async instead.Is it free, or is there a license catch?It's free — distributed under the same terms as Vim itself, with copyright by Tim Pope. The repo has been on GitHub since 2009 and sits at roughly 21.8k stars.
It's free — distributed under the same terms as Vim itself, with copyright by Tim Pope. The repo has been on GitHub since 2009 and sits at roughly 21.8k stars.What can it actually do once it's installed?The heart is :Git (or just :G), which runs any arbitrary Git command — if you know Git at the command line, you already know it. Run bare :Git and you get a summary window of dirty files plus unpushed and unpulled commits (the successor to :Gstatus); :Git commit and :Git rebase -i do their editing right in your current Vim, and verbose output like :Git diff or :Git log loads into temporary buffers.
The heart is :Git (or just :G), which runs any arbitrary Git command — if you know Git at the command line, you already know it. Run bare :Git and you get a summary window of dirty files plus unpushed and unpulled commits (the successor to :Gstatus); :Git commit and :Git rebase -i do their editing right in your current Vim, and verbose output like :Git diff or :Git log loads into temporary buffers.How does staging and diffing work inside it?:Gwrite stages the current file — it writes to both the work tree and the index, like git add. :Gread is an undoable checkout into the buffer, and :Gdiffsplit opens the staged version side by side with the working tree so you can edit the staged buffer and write to stage. :GMove and :GDelete wrap git mv and git rm on the current file.
:Gwrite stages the current file — it writes to both the work tree and the index, like git add. :Gread is an undoable checkout into the buffer, and :Gdiffsplit opens the staged version side by side with the working tree so you can edit the staged buffer and write to stage. :GMove and :GDelete wrap git mv and git rm on the current file.What's the deal with :Git blame?It opens a temporary buffer with maps for triage: press Enter on a line to view the commit where it changed, or g? to see other maps. Without a filename it blames the currently edited file in a vertical, scroll-bound split. Relatedly, :Gedit HEAD~3:% loads the current file as it existed three commits ago.
It opens a temporary buffer with maps for triage: press Enter on a line to view the commit where it changed, or g? to see other maps. Without a filename it blames the currently edited file in a vertical, scroll-bound split. Relatedly, :Gedit HEAD~3:% loads the current file as it existed three commits ago.Can it open a file on GitHub or GitLab?Yes — :GBrowse opens the current file on your hosting provider's web front-end, optionally limited to a visual-mode line range. GitHub, GitLab, Bitbucket, Gitee, Pagure, Phabricator, Azure DevOps and sourcehut are supported through companion plugins like rhubarb.vim and fugitive-gitlab.vim.
Yes — :GBrowse opens the current file on your hosting provider's web front-end, optionally limited to a visual-mode line range. GitHub, GitLab, Bitbucket, Gitee, Pagure, Phabricator, Azure DevOps and sourcehut are supported through companion plugins like rhubarb.vim and fugitive-gitlab.vim.What are similar projects?fzf.vim, diff-so-fancy, nerdtree, vim-airline, vimrc, syntastic, vim-surround, vim-pathogen
fzf.vim, diff-so-fancy, nerdtree, vim-airline, vimrc, syntastic, vim-surround, vim-pathogenWhich topics is it in?vim-plugin, vim script, version-control, vim, editor, github, git, utility, command-line, developers, plugin, productivity
vim-plugin, vim script, version-control, vim, editor, github, git, utility, command-line, developers, plugin, productivity