{"id":18109307,"url":"https://github.com/girishji/vimsuggest","last_synced_at":"2025-04-02T03:31:22.838Z","repository":{"id":257969688,"uuid":"861606383","full_name":"girishji/vimsuggest","owner":"girishji","description":"Auto-completion for Vim's command-line.","archived":false,"fork":false,"pushed_at":"2024-10-29T14:15:09.000Z","size":1664,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-29T17:23:51.816Z","etag":null,"topics":["autocomplete","vim","vim-cmd","vim-plugin","vim-search","vim9-plugin","vim9-script","vim9script"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/girishji.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-23T07:59:19.000Z","updated_at":"2024-10-29T14:15:13.000Z","dependencies_parsed_at":"2024-11-06T15:25:10.549Z","dependency_job_id":"6070f749-991d-4763-be54-edd4b8989bbb","html_url":"https://github.com/girishji/vimsuggest","commit_stats":null,"previous_names":["girishji/vimsuggest"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/girishji%2Fvimsuggest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/girishji%2Fvimsuggest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/girishji%2Fvimsuggest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/girishji%2Fvimsuggest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/girishji","download_url":"https://codeload.github.com/girishji/vimsuggest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246750867,"owners_count":20827794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autocomplete","vim","vim-cmd","vim-plugin","vim-search","vim9-plugin","vim9-script","vim9script"],"created_at":"2024-11-01T00:01:41.823Z","updated_at":"2025-04-02T03:31:22.830Z","avatar_url":"https://github.com/girishji.png","language":"Vim Script","funding_links":[],"categories":["Vim Script","Completion"],"sub_categories":[],"readme":"# VimSuggest: Supercharge Your Vim Command-Line\n\nThe ultimate auto-completion plugin for Vim command-line.\n\n## 🚀 Enhance Vim Workflow\n\n- **Command Completion**: Never struggle to remember complex commands again.\n- **Search Suggestions**: Access relevant search terms with fewer keystrokes, enhancing your navigation.\n\n## 🌟 Additional Features\n\nVimSuggest goes beyond basic auto-completion, offering a suite of advanced features by leveraging Vim's native custom completion mechanism (`:h :command-completion-custom`). These features feel like a natural extension of the editor, but they can be easily disabled if desired.\n\n- **Asynchronous Fuzzy File Search** (`:VSFind`): Effortlessly locate files across your entire project with minimal keystrokes.\n- **Real-Time Live Grep** (`:VSGrep`): Instantly find text across your entire codebase using glob or regex patterns.\n- **Fuzzy Search**: Quickly locate buffers (`:VSBuffer`) and search various Vim artifacts.\n- **In-Buffer Search** (`:VSGlobal`): Leverage Vim's powerful `:global` command for lightning-fast buffer searches.\n- **Include File Search** (`:VSInclSearch`): Seamlessly search across included files using Vim's `:ilist` command.\n- **Live File Search** (`:VSFindL`): Asynchronously search for files using glob or regex patterns.\n- **Custom Shell Command Execution** (`:VSExec`): Run and interact with shell commands directly within Vim.\n\nAuto-completion can also be disabled by default and only triggered when the `\u003cTab\u003e` key is pressed, which more closely aligns with Vim's default behavior.\n\n---------\n\n![Demo](https://gist.githubusercontent.com/girishji/40e35cd669626212a9691140de4bd6e7/raw/f931e4198209452a7626bc2a6f2118dd27dac1dd/vimsuggest-demo.gif)\n\n---------\n\n## Requirements\n\n- Vim version 9.1 or higher\n\n## Installation\n\nInstall VimSuggest via [vim-plug](https://github.com/junegunn/vim-plug) or Vim's built-in package manager.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eShow installation instructions\u003c/b\u003e\u003c/summary\u003e\n\n### Using vim-plug\n\nAdd the following to your `.vimrc`:\n\n```vim\ncall plug#begin()\nPlug 'girishji/vimsuggest'\ncall plug#end()\n```\n\n### Using Vim's built-in package manager\n\n#### Linux\n\n```bash\ngit clone https://github.com/girishji/vimsuggest.git $HOME/.vim/pack/downloads/opt/vimsuggest\n```\n\nThen add this line to your _vimrc_ file:\n\n```vim\npackadd vimsuggest\n```\n\n#### Windows\n\n```bash\ngit clone https://github.com/girishji/vimsuggest.git %USERPROFILE%\\vimfiles\\pack\\downloads\\opt\\vimsuggest\n```\n\nThen add this line to your _vimrc_ file:\n\n```vim\npackadd vimsuggest\n```\n\n\u003c/details\u003e\n\n## Configuration Guide\n\nVimSuggest offers extensive customization options for both command completion and search completion.\n\n### Command Completion Configuration\n\n```vim\nlet s:vim_suggest = {}\nlet s:vim_suggest.cmd = {\n    \\ 'enable': v:true,\n    \\ 'pum': v:true,\n    \\ 'exclude': [],\n    \\ 'onspace': ['b\\%[uffer]','colo\\%[rscheme]'],\n    \\ 'alwayson': v:true,\n    \\ 'popupattrs': {},\n    \\ 'wildignore': v:true,\n    \\ 'addons': v:true,\n    \\ 'trigger': 't',\n    \\ 'reverse': v:false,\n    \\ 'prefixlen': 1,\n\\ }\n```\n\n| Variable Name | Default Value | Comment |\n|---------------|---------------|---------|\n| `enable` | `v:true` | Enable/disable command completion |\n| `pum` | `v:true` | `v:true` for stacked menu, `v:false` for flat menu |\n| `exclude` | `[]` | Regex patterns to exclude from completion |\n| `onspace` | `['b\\%[uffer]','colo\\%[rscheme]']` | Commands (regex) that trigger completion after space. Use `.*` for all |\n| `alwayson` | `v:true` | Auto-open popup (`v:false` to open with `\u003cTab\u003e`/`\u003cC-d\u003e`) |\n| `popupattrs` | `{}` | Arguments passed to popup_create() (`:h popup_create-arguments`) |\n| `wildignore` | `v:true` | Respect 'wildignore' during file completion |\n| `addons` | `v:true` | Enable addons (`:VSxxx` commands) |\n| `trigger` | `t` | `'t'` enables `\u003cTab\u003e`/`\u003cS-Tab\u003e` as trigger characters, while `'n'` enables `\u003cC-n\u003e`/`\u003cC-p\u003e` and `\u003cUp\u003e/\u003cDown\u003e`. (See note below.) |\n| `reverse` | `v:false` | Reverse-sorted menu, with the most relevant item at the bottom (when `pum=v:true`) |\n| `auto_first` | `v:false` | Auto-select first menu item on `\u003cEnter\u003e` if none chosen (Does not affect 'addons' which always use first item) |\n| `prefixlen` | `1` | The minimum prefix length before the completion menu is displayed\n| `complete_sg` | `v:true` | Enables word completion (from the buffer) for the `:substitute` (`:s`) and `:global` (`:g`) commands |\n\n\u003e [!NOTE]\n\u003e 1. The `trigger` option specifies the character used to select items in the popup menu or invoke the menu itself. When `\u003cTab\u003e`/`\u003cC-I\u003e` is set as the trigger, it cannot be used to input tab characters while the popup is open. In this case, use `\u003cC-V\u003e\u003cTab\u003e`/`\u003cC-V\u003e\u003cC-I\u003e`.\n\u003e    - These trigger options can be combined. For instance, setting `tn` allows `\u003cTab\u003e`/`\u003cS-Tab\u003e` as well as `\u003cC-n\u003e`/`\u003cC-p\u003e` and `\u003cUp\u003e`/`\u003cDown\u003e` to navigate the menu. However, history recall using the arrow keys will only work when the command-line is empty.\n\u003e 2. If the popup menu does not appear due to a match in the `exclude` list, typing `\u003cC-D\u003e` will override the `exclude` list and immediately display the completion menu.\n\u003e 3. To enable fuzzy completion matching, use the command `:set wildoptions+=fuzzy`.\n\n### Search Completion Configuration\n\n```vim\nlet s:vim_suggest.search = {\n    \\ 'enable': v:true,\n    \\ 'pum': v:true,\n    \\ 'fuzzy': v:false,\n    \\ 'alwayson': v:true,\n    \\ 'popupattrs': {\n    \\   'maxheight': 12\n    \\ },\n    \\ 'range': 100,\n    \\ 'timeout': 200,\n    \\ 'async': v:true,\n    \\ 'async_timeout': 3000,\n    \\ 'async_minlines': 1000,\n    \\ 'highlight': v:true,\n    \\ 'trigger': 't',\n    \\ 'prefixlen': 1,\n\\ }\n```\n\n| Variable Name | Default Value | Comment |\n|---------------|---------------|---------|\n| `enable` | `v:true` | Enable/disable search completion |\n| `pum` | `v:true` | `v:true` for stacked menu, `v:false` for flat menu |\n| `fuzzy` | `v:false` | Enable fuzzy completion |\n| `alwayson` | `v:true` | Auto-open popup (`v:false` to open with `\u003cTab\u003e`/`\u003cC-d\u003e`) |\n| `popupattrs` | `{'maxheight': 12}` | Arguments passed to popup_create() (`:h popup_create-arguments`) |\n| `range` | `100` | Lines to search in each batch |\n| `timeout` | `200` | Non-async search timeout (ms) |\n| `async` | `v:true` | Use asynchronous searching |\n| `async_timeout` | `3000` | Async search timeout (ms) |\n| `async_minlines` | `1000` | Min lines to trigger async search |\n| `highlight` | `v:true` | 'false' to disable menu highlighting (for performance) |\n| `trigger` | `t` | `'t'` enables `\u003cTab\u003e`/`\u003cS-Tab\u003e` as trigger characters, while `'n'` enables `\u003cC-n\u003e`/`\u003cC-p\u003e` and `\u003cUp\u003e/\u003cDown\u003e`. (See note above.) |\n| `reverse` | `v:false` | Reverse-sorted menu, with the most relevant item at the bottom (when `pum=v:true`) |\n| `prefixlen` | `1` | The minimum prefix length before the completion menu is displayed\n\n\u003e [!IMPORTANT]\n\u003e 1. Searching large files will not cause any lag. By default, searching is concurrent. Even though no external jobs are used, a timer pauses the task at regular intervals to check if there are pending keys on the typehead.\n\u003e 2. When searching across line boundaries (`\\n`), search highlighting will be turned off.\n\n### Applying Configuration\n\nTo apply your configuration:\n\n```vim\ncall g:VimSuggestSetOptions(s:vim_suggest)\n```\n\nIf you are using [vim-plug](https://github.com/junegunn/vim-plug) you may have to do:\n\n```vim\nautocmd VimEnter * call g:VimSuggestSetOptions(s:vim_suggest)\n```\n\n\n### Global Enable/Disable\n\nEnable or disable VimSuggest globally:\n\n```vim\n:VimSuggestEnable   \" Enable VimSuggest\n:VimSuggestDisable  \" Disable VimSuggest\n```\n\n### Highlighting\n\nVimSuggest uses custom highlight groups:\n\n- `VimSuggestMatch`: Highlights matched portion of the text. Linked to `PmenuMatch` by default.\n- `VimSuggestMatchSel`: Highlights matched text in the selected item of the menu. Linked to `PmenuMatchSel` by default.\n- `VimSuggestMute`: Highlights passive text, like line numbers in `grep` output. Linked to `LineNr` by default.\n\n### Customization Examples\n\n```vim\n\" Customize popup window appearance\nlet s:vim_suggest.cmd.popupattrs = {\n    \\ 'borderchars': ['─', '│', '─', '│', '┌', '┐', '┘', '└'],\n    \\ 'borderhighlight': ['Normal'],\n    \\ 'highlight': 'Normal',\n    \\ 'border': [1, 1, 1, 1],\n    \\ 'maxheight': 20,\n    \\ }\n\n\" Exclude specific patterns from completion\n\"   To exclude :[N]b[uffer][!] and :[N]sb[uffer][!] do:\nlet s:vim_suggest.cmd.exclude = [\n    \\ '^\\s*\\d*\\s*b\\%[uffer]!\\?\\s\\+',\n    \\ '^\\s*\\d*\\s*sb\\%[uffer]!\\?\\s\\+'\n    \\ ]\n\n\" Apply the configuration\ncall g:VimSuggestSetOptions(s:vim_suggest)\n\n\" Customize highlight groups\nhighlight VimSuggestMatch ctermfg=Green guifg=#00FF00\nhighlight VimSuggestMatchSel cterm=bold gui=bold ctermfg=Green guifg=#00FF00\nhighlight VimSuggestMute ctermfg=Gray guifg=#808080\n```\n\n## Key Bindings\n\nWhen the popup window is open, you can use the following key mappings:\n\n| Key | Action |\n|-----|--------|\n| `\u003cPageDown\u003e`/`\u003cS-Down\u003e` | Scroll down one page |\n| `\u003cPageUp\u003e`/`\u003cS-Up\u003e` | Scroll up one page |\n| `\u003cTab\u003e` | Move to next item |\n| `\u003cShift-Tab\u003e` | Move to previous item |\n| `\u003cC-n\u003e`/`\u003cDown\u003e` | Move to next item (see `trigger` option) |\n| `\u003cC-p\u003e`/`\u003cUp\u003e` | Move to previous item  (see `trigger` option) |\n| `\u003cEsc\u003e`/`\u003cC-[\u003e`/`\u003cC-c\u003e` | Dismiss popup |\n| `\u003cC-s\u003e` | Dismiss auto-completion and revert to default Vim behavior |\n| `\u003cC-e\u003e` | Dismiss auto-completion popup temporarily |\n| `\u003cEnter\u003e` | Confirm selection |\n| `\u003cC-d\u003e` | Open popup menu (override `exclude` list) |\n| `\u003cC-j\u003e` | Open file selection in a split window |\n| `\u003cC-v\u003e` | Open file selection in a vertical split |\n| `\u003cC-t\u003e` | Open file selection in a new tab |\n| `\u003cC-q\u003e` | Send items (grep lines or file paths) to the quickfix list |\n| `\u003cC-l\u003e` | Send items (file paths) to the argument list |\n| `\u003cC-g\u003e` | Copy items to system clipboard (`+` register) |\n\nNote: Keys used in command-line editing (`:h cmdline-editing`) remain unmodified.\n\n\u003e [!TIP]\n\u003e 1. To automatically open the quickfix list after using `\u003cC-q\u003e`, add the following to your `.vimrc`:\n\u003e    ```vim\n\u003e    augroup vimsuggest-qf-show\n\u003e        autocmd!\n\u003e        autocmd QuickFixCmdPost clist cwindow\n\u003e    augroup END\n\u003e    ```\n\u003e 2. When `\u003cEnter\u003e` is pressed without selection: addons always use first item, other commands do so if `auto_first` is set.\n\u003e 3. To perform a multi-word search using the `/` or `?` command, type the first word followed by `\u003cSpace\u003e` to trigger auto-completion for the next word. At the end of a line, press `\\n` to continue the search on the next line. Note that enabling the fuzzy search option will disable multi-word search functionality.\n\u003e 4. When completing files during `:edit` command, `\u003cTab\u003e` (trigger character) selects subsequent items in the menu. In order to step into a directory select the directory and press `/`; it will populate items from that directory.\n\n### Customizing Key Bindings\n\nYou can remap the following keys by configuring the option as shown below:\n\n```vim\nlet s:vim_suggest.keymap = {\n    \\ 'page_up': [\"\\\u003cPageUp\u003e\", \"\\\u003cS-Up\u003e\"],\n    \\ 'page_down': [\"\\\u003cPageDown\u003e\", \"\\\u003cS-Down\u003e\"],\n    \\ 'hide': \"\\\u003cC-e\u003e\",\n    \\ 'dismiss': \"\\\u003cC-s\u003e\",\n    \\ 'send_to_qflist': \"\\\u003cC-q\u003e\",\n    \\ 'send_to_arglist': \"\\\u003cC-l\u003e\",\n    \\ 'send_to_clipboard': \"\\\u003cC-g\u003e\",\n    \\ 'split_open': \"\\\u003cC-j\u003e\",\n    \\ 'vsplit_open': \"\\\u003cC-v\u003e\",\n    \\ 'tab_open': \"\\\u003cC-t\u003e\",\n\\ }\n```\n\nApply the configuration as follows:\n\n```vim\ncall g:VimSuggestSetOptions(s:vim_suggest)\n```\n\nIf you are using [vim-plug](https://github.com/junegunn/vim-plug) you may have to do:\n\n```vim\nautocmd VimEnter * call g:VimSuggestSetOptions(s:vim_suggest)\n```\n\n## Addons\n\nWhen the `addons` option is set to `v:true`, the following commands are made available. You can use these commands directly or map them to your preferred keys.\n\n1. **Fuzzy Find Files**\n\n   `:VSFind [dirpath] [fuzzy_pattern]`\n\n   This runs the system's `find` program (or alternatives) asynchronously to gather files for fuzzy searching. The optional first argument is the directory to search within.\n\n   Example key mappings:\n\n   ```vim\n   nnoremap \u003ckey\u003e :VSFind\u003cspace\u003e\n   nnoremap \u003ckey\u003e :VSFind ~/.vim\u003cspace\u003e\n   nnoremap \u003ckey\u003e :VSFind $VIMRUNTIME\u003cspace\u003e\n   ```\n\n   The 'find' program can be specified through the `g:vimsuggest_fzfindprg` variable. If this variable is not defined, a default command is used (that ignores hidden files and directories). The placeholder \"$*\" is allowed to specify where the optional directory argument will be included. If placeholder is not specifed, directory name is included at the end. Environment variables and tilde are expanded for directory names.\n\n   ```vim\n   let g:vimsuggest_fzfindprg = 'find $* \\! \\( -path \"*/.*\" -prune \\) -type f -follow'\n   let g:vimsuggest_fzfindprg = 'fd --type f .'\n   ```\n\n   (Optional) To execute the program through a shell:\n\n   ```vim\n   let g:vimsuggest_shell = true\n   set shell=/bin/sh\n   set shellcmdflag=-c\n   ```\n\n   Performance:\n\n   Using the system's `find` program significantly outperforms Vim's `:find` command. On the Vim source repository, it takes ~1 second to list all files using `:find **/*` command, while `:VSFind` takes ~30 milliseconds (30x faster). Shell's recursive glob wildcard can be [slow](https://github.com/vim/vim/issues/15791).\n\n2. **Fuzzy Search Buffers and Other Vim Artifacts**\n\n   ```\n   :VSBuffer [fuzzy_pattern]\n   :VSGitFind [dir] [fuzzy_pattern]\n   :VSMru [fuzzy_pattern]\n   :VSKeymap [fuzzy_pattern]\n   :VSMark [fuzzy_pattern]\n   :VSRegister [fuzzy_pattern]\n   :VSChangelist [fuzzy_pattern]\n   ```\n\n   - `VSBuffer`: Search and switch between currently open buffers\n      - Displays matching buffers as you type\n   - `VSGitFind`: Smart file search with Git awareness\n      - In Git repositories: Searches tracked files\n      - Outside Git (or if 'dir' is given): Falls back to regular file search (like `VSFind`)\n   - `VSMru`: Access recently used files\n      - Lists files from Vim's `v:oldfiles` history\n      - Example: Quickly return to files you edited yesterday\n   - `VSKeymap`: Navigate to keymap definitions\n      - Opens the source file containing the definition of keymap\n   - `VSMark`: Quick mark navigation\n      - Jump to any mark location in your files\n   - `VSRegister`: Register content access\n      - Paste the content of register\n   - `VSChangelist`: Navigate through changes\n      - Jump to any point in the file's change history\n      - See `:help changelist` for details\n\n   Example key mapping:\n\n   ```vim\n   nnoremap \u003ckey\u003e :VSBuffer\u003cspace\u003e\n   ```\n\n3. **Live Grep Search**\n\n   `:VSGrep {pattern} [directory]`\n\n   Executes a `grep` command live, showing results as you type. `{pattern}` is given directly to `grep` command, and it's best to enclose it in quotes to handle special characters. You can also specify an optional directory.\n\n   Example key mappings:\n\n   ```vim\n   nnoremap \u003ckey\u003e :VSGrep \"\"\u003cleft\u003e\n   nnoremap \u003ckey\u003e :VSGrep \"\u003cc-r\u003e=expand('\u003ccword\u003e')\u003ccr\u003e\"\u003cleft\u003e\n   ```\n\n   The grep program is taken from `g:vimsuggest_grepprg` variable or the `:h 'grepprg'` option. If it contains `$*`, it gets replaced by the command-line arguments. Otherwise, arguments are appended to the end of the command.\n\n   ```vim\n   let g:vimsuggest_grepprg = 'grep -REIHins $* --exclude-dir=.git --exclude=\".*\"'\n   let g:vimsuggest_grepprg = 'rg --vimgrep --smart-case $* .'\n   let g:vimsuggest_grepprg = 'ag --vimgrep'\n   ```\n\n4. **Live File Search**\n\n   `:VSFindL {pattern} [directory]`\n\n   This command runs system's `find` program live, showing results as you type. `{pattern}` is a glob (or regex) pattern that should be enclosed in quotes if it contains wildcards. The `find` command is customized via `g:vimsuggest_findprg` (similar to `g:vimsuggest_fzfindprg`).\n\n   Example key mapping and configuring 'find' program:\n\n   ```vim\n   nnoremap \u003ckey\u003e :VSFindL \"*\"\u003cleft\u003e\u003cleft\u003e\n   let g:vimsuggest_findprg = 'find -EL $* \\! \\( -regex \".*\\.(swp\\|git)\" -prune \\) -type f -name $*'\n   \" Using fd:\n   nnoremap \u003ckey\u003e :VSFindL\u003cspace\u003e\n   let g:vimsuggest_findprg = 'fd --type f'\n   let g:vimsuggest_findprg = 'fd --type f --glob'\n   ```\n\n5. **In-Buffer Search (`:h :global`)**\n\n   `:VSGlobal {regex_pattern}`\n\n   Use this for a powerful in-buffer search with Vim's regex. For example, to list all functions and classes in a Python file and jump quickly:\n\n   ```vim\n   nnoremap \u003cbuffer\u003e \u003ckey\u003e :VSGlobal \\v(^\\|\\s)(def\\|class).{-}\n   ```\n\n6. **Search in Included Files (`:h include-search`)**\n\n   `:VSInclSearch {regex_pattern}`\n\n   Similar to `VSGlobal`, but searches for symbols (ignoring comments) in both the current buffer and included files. The results are gathered using the `:ilist` command.\n\n   Example key mapping:\n\n   ```vim\n   nnoremap \u003ckey\u003e :VSInclSearch\u003cspace\u003e\n   ```\n\n7. **Execute Shell Command**\n\n   `:VSExec {shell_command}`\n\n   This command runs any shell command using your `$SHELL` environment, allowing features like brace expansion and globbing. Errors are ignored. However, `:VSGrep` and `VSFindL` commands are less clunky.\n\n   Example key mappings:\n\n   ```vim\n   nnoremap \u003ckey\u003e :VSExec fd --type f\u003cspace\u003e\n   nnoremap \u003ckey\u003e :VSExec grep -RIHins \"\" . --exclude-dir={.git,\"node_*\"} --exclude=\".*\"\u003cc-left\u003e\u003cc-left\u003e\u003cc-left\u003e\u003cleft\u003e\u003cleft\u003e\n   \" Easier to type but low performance:\n   nnoremap \u003ckey\u003e :VSExec grep -IHins \"\" **/*\u003cc-left\u003e\u003cleft\u003e\u003cleft\u003e\n   ```\n\n\u003e [!IMPORTANT]\n\u003e External programs are executed directly if `g:vimsuggest_shell` is `v:false`. Otherwise, they are executed through shell as specified in `shell` option (`:h 'shell'`). Using shell allows for expansion of `~`, `$VAR`, `**` (if your shell supports), etc.\n\u003e ```vim\n\u003e let g:vimsuggest_shell = v:true\n\u003e set shell=/bin/zsh\n\u003e set shellcmdflag=-c\n\u003e ```\n\u003e See also `:h expandcmd()`\n\n\u003e [!TIP]\n\u003e If these commands aren't sufficient, you can define your own using the examples provided in `autoload/vimsuggest/addons/addons.vim` script. Legacy script users can import using `:import` also (see `:h import-legacy`).\n\n## Other Plugins\n\nFor insert-mode auto-completion, try [**Vimcomplete**](https://github.com/girishji/vimcomplete).\n\n## Contributing\n\nOpen an issue if you encounter problems. Pull requests are welcomed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgirishji%2Fvimsuggest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgirishji%2Fvimsuggest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgirishji%2Fvimsuggest/lists"}