Skip to content

gabesoft/vim-ags

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
doc
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
_____     ____  ______
\__  \   / ___\/  ___/
 / __ \_/ /_/  >___ \ 
(____  /\___  /____  >
     \//_____/     \/ 

Silver searcher (AG) plugin for Vim

A Vim plugin for the silver searcher or ripgrep that focuses on
clear display and easy navigation of the search results

Installation

Install via pathogen, vundle, plug or copy to the Vim directory
The ag or rg executable must be installed as well.

Usage

See the docs or press u (for usage) while in the search results window.

Using ripgrep instead of ag

Despite the name vim-ags works with ripgrep as well if configured as below:

let g:ags_agexe = 'rg'

let g:ags_agargs = {
  \ '--column'         : ['', ''],
  \ '--line-number'    : ['', ''],
  \ '--context'        : ['g:ags_agcontext', '-C'],
  \ '--max-count'      : ['g:ags_agmaxcount', ''],
  \ '--heading'        : ['',''],
  \ '--smart-case'     : ['','-S'],
  \ '--color'          : ['always',''],
  \ '--colors'         : [['match:fg:green', 'match:bg:black', 'match:style:nobold', 'path:fg:red', 'path:style:bold', 'line:fg:black', 'line:style:bold'] ,''],
  \ }

Sample Shortcut Mappings

" Search for the word under cursor
nnoremap <Leader>s :Ags<Space><C-R>=expand('<cword>')<CR><CR>
" Search for the visually selected text
vnoremap <Leader>s y:Ags<Space><C-R>='"' . escape(@", '"*?()[]{}.') . '"'<CR><CR>
" Run Ags
nnoremap <Leader>a :Ags<Space>
" Quit Ags
nnoremap <Leader><Leader>a :AgsQuit<CR>

Notes

Works with ag version >= 0.29.1 or ripgrep >= 11.0.2

Screenshots

Here are a couple of screenshots of the search results window

View mode (with lightline integration)

Edit mode

Similar Plugins

ctrlsf