Skip to content

tylerw/vim-grepper

This branch is 19 commits ahead of, 3 commits behind mhinz/vim-grepper:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e709e8d Â· Aug 8, 2024
Aug 30, 2021
Nov 9, 2016
Aug 8, 2024
May 8, 2019
May 6, 2022
May 8, 2019
Nov 11, 2016
Jul 29, 2015
Jan 21, 2016
Apr 23, 2018

Repository files navigation

Build Status



vim-grepper



Use your favorite grep tool (ag, ack, git grep, ripgrep, pt, sift, findstr, grep) to start an asynchronous search. All matches will be put in a quickfix or location list.

This plugin works with Vim and Neovim on Unix-like systems. It's mostly working on Windows as well.

Disclaimer: From my point of view it's feature-complete, so I won't add new features or put much time into reviewing complex PRs.


  • Prompt: Use :Grepper to open a prompt, enter your query, optionally cycle through the list of tools, fire up the search.
  • Operator: Use the current visual selection to pre-fill the prompt or start searching right away.
  • Commands: :Grepper supports a wide range of flags which makes it extremely flexible. All supported tools come with their own command for convenience: :GrepperGit, :GrepperAg, and so on. They're all built atop of :Grepper.
  • Custom tools: Changing the behaviour of the default tools is very easy. And so is adding new tools.

If you like ack.vim and ag.vim, you will love vim-grepper.

Documentation

This README is only the tip of the iceberg. Make sure to read :h grepper and the wiki to learn about every feature.

Example configurations be be found here.

The truth is out there.

Installation

Use your favorite plugin manager, e.g. vim-plug:

Plug 'mhinz/vim-grepper'

If you prefer lazy loading:

Plug 'mhinz/vim-grepper', { 'on': ['Grepper', '<plug>(GrepperOperator)'] }

Demo

General usage:

vim-grepper

Grepping only files currently loaded in Vim:

vim-grepper

Feedback

If you like this plugin, star it! It's a great way of getting feedback. The same goes for reporting issues or feature requests.

Contact: Twitter

About

👾 Helps you win at grep.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Vim Script 97.9%
  • Shell 2.1%