Grug-far is a find and replace plugin for Neovim that provides a powerful and intuitive way to search and replace text within buffers. It leverages the speed and flexibility of ripgrep and optionally ast-grep for advanced search capabilities. Grug-far aims to be user-friendly, transparent about its underlying tools, and adaptable to various editing workflows.
Grug-far stands out by offering a transparent approach to search, exposing the underlying ripgrep and ast-grep tools and their flags. It also emphasizes user control by avoiding excessive automation and preserving existing editing habits. The plugin's ability to use lua-interpreted replacements and sync results back to their originating files provides a unique level of flexibility.
- Powerful Search Engines: Supports ripgrep and optional ast-grep for robust and versatile search capabilities with multiple flags.
- Debounced Search: Automatically initiates search on leaving insert mode or normal mode changes for efficient workflows.
- Flexible Replacement: Allows for replacement using ripgrep, ast-grep, or custom lua/vimscript interpreted replacements.
- Transparent Tooling: Displays error messages from ripgrep and ast-grep directly, promoting learning and understanding.
- Result Sync: Enables syncing the text of search results back to their original files for easy editing and modification.
Grug-far is an actively maintained plugin with a growing community and regular updates. It enjoys a stable release history, responsive issue tracking, and comprehensive documentation, suggesting a reliable and evolving solution for Neovim users.
Grug-far benefits developers and power users who require efficient and flexible find and replace functionality within Neovim. It enhances productivity by providing powerful search tools, transparent operation, and customizable replacement options. Unlike basic search functionalities, Grug-far offers advanced features and control, empowering users to perform complex text manipulations with ease.