https://github.com/adithyasource/spearmint.nvim
harpoon style marks plugin
https://github.com/adithyasource/spearmint.nvim
neovim neovim-dotfiles neovim-lua-plugin neovim-marks neovim-plugin
Last synced: about 1 month ago
JSON representation
harpoon style marks plugin
- Host: GitHub
- URL: https://github.com/adithyasource/spearmint.nvim
- Owner: adithyasource
- License: unlicense
- Created: 2026-04-09T11:54:27.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-29T09:30:38.000Z (3 months ago)
- Last Synced: 2026-05-07T03:05:08.365Z (3 months ago)
- Topics: neovim, neovim-dotfiles, neovim-lua-plugin, neovim-marks, neovim-plugin
- Language: Lua
- Homepage:
- Size: 23.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-neovim-sorted - adithyasource/spearmint.nvim
- awesome-neovim - adithyasource/spearmint.nvim - Lightweight harpoon-style marks with terminal support. (Marks / Markdown and LaTeX)
- awesome - spearmint.nvim - Lightweight harpoon-style marks with terminal support for Neovim. Part of Awesome Neovim Marks / Assembly updates. ([Read more](/details/spearmintnvim.md)) `Neovim` `Open Source` `Terminal` (Development Tools)
README
# spearmint
no bs upgrade to default neovim marks but in ~100 LOC
## demo
https://github.com/user-attachments/assets/b2264a19-f778-468c-aab4-85cd73112885
## to install
with nvim 0.12.0+
```lua
vim.pack.add({ "https://github.com/adithyasource/spearmint.nvim" })
```
or add `adithyasource/spearmint.nvim` to your favourite package manager of choice
or install it manually
```bash
git clone https://github.com/adithyasource/spearmint.nvim ~/.config/nvim/pack/nvim/start/spearmint.nvim
```
add this to your config to enable its functionality
```lua
require('spearmint').setup()
```
and configure the jump and set_mark keymaps
```lua
vim.keymap.set("n", "m", function() Spearmint.set_mark() end)
vim.keymap.set("n", "'", function() Spearmint.jump() end)
```
> i like to override the functionality of vim marks so i use the `m` and `'` key to use spearmint but you can set your own keymaps
## how to use
- hit the `set_mark` key followed by any character and your file will be assigned to that key.
- as you move around files and change locations, if you ever need to go back to that file, hit the `jump` key followed by the character you want
- you'll be taken back to your last position in that file
## why?
i wanted something not as heavy as harpoon; it has a ui which i end up not using often, so i ended up using default vim marks but they had no project context and required me to hit caps lock for setting "global" marks. thus, i ended up making this: has project wise marks, really lightweight and works with terminal buffers :]
## acknowledgments
inspired by
harpoon (theprimeagen)