A vim plugin to improve the project search experience when using tools like ag and rg.

• Rationale
• Installation
• Usage
• Mappings
• Customization
• How It Works

I was inspired by fzf.vim's ability to quickly :Ag search multiple words without quotes, narrow down multiple results in realtime with extended search syntax, then populate quickfix for a large refactor 👌

:Ag function index

But I found myself missing the ability to pass command line options like I could with ack.vim's :Ack 😢

:Ack -Q -i 'function index' vendor

Furthermore, fzf.vim's :Ag treats quotes as a literal part of the search query, which is inconsistent with ag on the command line.

Thus, the intention of this plugin is to bring the best of both worlds to your favourite search wrapper. Perform multi-word searches with or without quotes, pass command line options, and do it all from one command.

Read more about my project searching workflow with fzf.vim and agriculture ❤️

Install using vim-plug or similar:

Plug 'jesseleite/vim-agriculture'

If you are already using fzf.vim, you can use the provided :AgRaw / :RgRaw commands.

:AgRaw func.*index
:AgRaw 'func.*index'
:AgRaw -Q 'function index()' app/Http/Controllers

Likewise for :RgRaw, just substitute AgRaw in RgRaw in the above examples.

If you are using another search wrapper, you'll need to wrap your input with agriculture#smart_quote_input().

If you are using one of the provided commands, you can hook into the provided <Plug> mappings in your .vimrc:

nmap <Leader>/ <Plug>AgRawSearch
vmap <Leader>/ <Plug>AgRawVisualSelection
nmap <Leader>* <Plug>AgRawWordUnderCursor

Likewise for :RgRaw, just substitute AgRaw in RgRaw in the above examples.

If you are using one of the provided commands, you can also set default command line options in your .vimrc:

let g:agriculture#ag_options = '--case-sensitive'

Again likewise for :RgRaw with g:agriculture#rg_options.

If you are using one of the provided commands, and want to disable smart quoting for CLI consistency:

let g:agriculture#disable_smart_quoting = 1

Preview windows are now rendered by default in many fzf.vim commands. If you wish to customize or disable this behaviour, see fzf.vim's documentation on preview windows.

Your input will be automatically quoted unless the following conditions are met:

• Quotes in your query, signifying you might want to handle your own quoting/escaping, ie.

  :Ag -Q "Already quoted this pattern."
  :Ag Why you "scruffy looking nerf herder"!
  :Ag Who's scruffy looking?
  

• A space followed by a dash in your query, signifying you might be passing an option, ie.

  :Ag -Q function index
  :Ag Which way to the beach? -> that way!
  

• An escaped pattern followed by an unescaped space, signifying you might be passing a path, ie.

  :Ag an\ escaped\ pattern vendor/folder
  

TL;DR: If you use quotes, dashes, or need to pass a path, it's recommended you quote/escape your own pattern and vim-agriculture will stay out of your way 👍

Just a hack 🔨

• jesseleite.com
• @jesseleite85