Question 1

How do I set up grug-far.nvim for inline editing and syncing changes?

Accepted Answer

Use the default keybind <localleader>r to trigger replace or sync actions after editing results in the buffer. The 'Sync All' action applies changes line-by-line, while 'Sync Line' handles individual edits, with recovery via undo if needed.

Question 2

grug-far.nvim compared to nvim-spectre: what are the key differences?

Accepted Answer

grug-far.nvim emphasizes transparency by showing CLI commands and uses a buffer-based interface with inline editing, while nvim-spectre offers a more integrated but less flexible quickfix approach. grug-far supports multiple engines like ast-grep, whereas nvim-spectre is more ripgrep-focused.

Question 3

Can grug-far.nvim handle AST-based search and replace with ast-grep?

Accepted Answer

Yes, it supports ast-grep for AST-based searches using patterns or YAML rules. You can switch engines with the 'Swap Engine' action, but note that inline sync editing is limited to ripgrep, so replacements require explicit actions.

Question 4

How to limit grug-far.nvim searches to a visual selection?

Accepted Answer

Use the :GrugFarWithin command in visual mode or set the visualSelectionUsage option in Lua to 'operate-within-range'. This pre-fills the search and limits it to the selected buffer range for targeted modifications.

Question 5

Does grug-far.nvim work with Lua interpreted replacements?

Accepted Answer

Yes, use the 'Swap Replacement Interpreter' action to switch to Lua mode, then write multi-line code in the replacement input that returns a string for each match, accessing variables like 'match' or 'vars' for ast-grep.

Question 6

How to integrate grug-far.nvim with file explorers like neo-tree?

Accepted Answer

The cookbook provides examples: add custom commands to open grug-far with the focused directory, using instance management to update paths dynamically without clearing other inputs, as shown in the neo-tree integration snippet.

grug-far.nvim

What is grug-far.nvim?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions