nvim-get-ref

Copy file references in Claude Code format directly from Neovim.

When you select code in Neovim and press <leader>yf, this plugin copies a reference like file.lua:10:5-15 to your clipboard. You can paste this reference into Claude Code to point to specific lines and columns.

Installation

lazy.nvim

{
  'WarrenZhu050413/nvim-get-ref',
  config = function()
    require('nvim-get-ref').setup()
  end,
}

packer.nvim

use {
  'WarrenZhu050413/nvim-get-ref',
  config = function()
    require('nvim-get-ref').setup()
  end,
}

Usage

Default Keybindings

• Visual mode: <leader>yf - Copy reference for selected text
• Normal mode: <leader>yf - Copy reference for cursor position

Examples

Single line selection (columns 5-15 on line 10):

/path/to/file.lua:10:5-15

Multi-line selection (line 10 col 5 to line 15 col 20):

/path/to/file.lua:10:5-15:20

Visual line mode (entire lines 10-15):

/path/to/file.lua:10:1-15

Single line (visual line mode on line 10):

/path/to/file.lua:10

Configuration

Custom Keybindings

require('nvim-get-ref').setup({
  keymaps = {
    visual = '<leader>yr',  -- Custom visual mode binding
    normal = '<leader>yr',  -- Custom normal mode binding
  },
})

Custom Register

require('nvim-get-ref').setup({
  register = '"',  -- Use default register instead of clipboard
  -- Other options: '+' (clipboard, default), '*' (selection), 'a'-'z' (named registers)
})

Disable Auto Keymaps

require('nvim-get-ref').setup({
  setup_keymaps = false,  -- Don't set up keybindings automatically
})

Then set your own:

vim.keymap.set('v', '<leader>yf', function()
  require('nvim-get-ref').yank_reference()
end)

vim.keymap.set('n', '<leader>yf', function()
  require('nvim-get-ref').yank_reference_normal()
end)

Commands

• :GetRefYank - Copy reference from visual selection
• :GetRefYankNormal - Copy reference from cursor position

How It Works

The plugin reads Neovim's visual selection marks ('< and '>) and formats them into Claude Code's file reference syntax. Line numbers are 1-indexed, matching Claude's file edit tools and standard text editor conventions. It handles:

• Character-wise visual mode (v)
• Line-wise visual mode (V)
• Block-wise visual mode (<C-v>)
• Edge cases (invalid positions, very long lines, etc.)

Testing

The plugin includes 27 tests (24 unit + 3 integration).

# Run unit tests
nvim --headless -u tests/minimal_init.lua -c "PlenaryBustedFile tests/unit/core_spec.lua" -c "qa!"

# Run integration tests
nvim --headless -u tests/minimal_init.lua -c "PlenaryBustedFile tests/integration/integration_spec.lua" -c "qa!"

Requires plenary.nvim for testing.

License

MIT