nolleh/warp.nvim

github

motion

10

0

0

0

CREATED

2026-01-21

UPDATED

2026-02-04

---

warp.nvim

A motion plugin for file jumping. Hop to file paths, not words.

Demo

https://github.com/user-attachments/assets/87b91299-bcf1-49af-95a4-be09752766ba

https://github.com/user-attachments/assets/1d9a2055-e67f-4663-9e1d-d21d09817dca

Why warp.nvim?

You're in a terminal buffer. A test fails. The error shows src/utils/parser.lua:42:15.

With other plugins? Copy the path, switch windows, open file, go to line, find column.

With warp.nvim? Press one key, type the hint, you're there.

  Error: assertion failed
  --> src/utils/parser.lua:42:15    [a] <- hint appears here
      expected: true
      got: false

Features

• Works everywhere - Regular buffers, terminal buffers, floating windows
• No terminal integration needed - Unlike kitty hints, works with any terminal emulator
• Line & column aware - Detects file.lua:42 and file.lua:42:15 patterns, jumps to exact position
• URL support - Opens URLs in your default browser (hints shown in green)
• Markdown link support - Follows [text](target) links including anchor links in .md files (hints shown in orange)
• Wrapped path support - Handles file paths broken across lines by terminal width
• Smart window targeting - Opens files in your editor window, not the terminal
• Split/Vsplit support - Prefix with S or V to open in split windows

Hint Colors

Installation

lazy.nvim

{
  "nolleh/warp.nvim",
  config = true,  -- Default keymap: <leader>w
  -- Or customize:
  -- config = function()
  --   require("warp").setup({
  --     default_keymap = "<leader>wf",  -- or false to disable
  --   })
  -- end,
  keys = { "<leader>w" }, -- your binding key (trigger lazy loading)
}

packer.nvim

use {
  "nolleh/warp.nvim",
  config = function()
    require("warp").setup()
  end
}

Usage

1. Press <leader>w (default) or run :Warp
2. Hint labels appear on detected file paths
3. Type the hint to jump

That's it. No configuration needed.

Split / Vsplit

Open files in split windows by prefixing the hint with uppercase S or V:

Keymap Configuration

Default keymap is <leader>w. You can customize or disable it:

require("warp").setup({
  default_keymap = "<leader>wf",  -- Custom keymap
  -- default_keymap = false,      -- Disable default keymap
})

License

MIT