🌍 oneloc.nvim

A simple plugin to keep track of a few important locations you want to jump to and from often. Provides 3 things:

• a function to record the current location nmap("<Leader><Leader>1", ":lua require('oneloc').record_cursor(1)<CR>")
• a function to jump to a recorded location namp("<Leader>1", ":lua require('oneloc').goto(1)<CR>")
• a simple ui to check what you have recorded:

• Red color = filename to get it at a glance 👀
• Green color = that's what your are going to find if you jump there 👍
• Gray color = that's what was there when you recorded the location 🤷‍♂️

From there you have a few options:

• ESC close the floating window.
• [1-5] jump to the corresponding location.
• D delete ALL the locations.
• d[1-5] delete location in position [1-5].
• u undo last insert/delete action (no redo)
• TAB toggle mode between marks (jump back to line/column where the location was saved) and file just open the file (may jump to last position, depending on your setup, see below)

What is this TAB you speak of?

• marks mode records the line + column of your cursor position so you can jump within a file, a handy replacement for marks
• files mode only sends you to the file as if you used :edit file. This is very handy if you set up your editor to restore the last location when re-opening a file check :h restore-cursor (or this issue).

📦 Installation

Requires neovim >= 0.9

Using lazy

{ 'lfrati/oneloc.nvim', config = function()
    -- values shown in setup are the defaults,
    -- feel free to call just require("oneloc").setup {} if you like them
    require("oneloc").setup {
      flash_t = 200,                --  ms
      mode = "marks",               --  marks: go back to the recorded cursor position information
                                    --  files: only go to that file, let your editor decide where
      width = 70,                   --  width of ui window

      colors = {
        flash = "OnelocFlash",      --  highlight cursor line
        file = "OnelocRed",         --  highlight filenames
        outdated = "OnelocGray",    --  highlight outdated line info
        uptodate = "OnelocGreen",   --  highlight uptodate line info
      }
    }
    for i=1,5 do
        -- <Leader>[1-5] to go somewhere
        vim.keymap.set({ "n" }, "<Leader>"..i, ":lua require('oneloc').goto("..i..")<CR>")
        -- <Leader><Leader>[1-5] to record someplace
        vim.keymap.set({ "n" }, "<Leader><Leader>"..i, ":lua require('oneloc').record_cursor("..i..")<CR>")
    end
    vim.keymap.set({ "n" }, "<Leader><Leader>o", ":lua require('oneloc').show()<CR>")

end }

🛠️ Configuration

Upon landing somewhere a flash helps find where the cursor is.

• Don't like it? Set flash_t = 0 in setup.
• Don't like the colors? Set ccolors.xyz = <HIGHLIGHT> in setup, where <HIGHLIGHT> is the name of an existing highlight group (up to you to make sure it exists!).
• Not enough space on screen? No worries, the location information shrinks as width shrinks

normal	shorter	shortest

Why oneloc.nvim?

Some time ago I stumbled upon harpoon. The idea is that you keep a persistent mapping between a small number of keys <-> locations. From my search plugin onesearch I've realized I really like simple minor-modes. Here is my take on a navigation plugin with a simple floating window and persistent locations. Hope you'll like it 🙂