Go to file
2025-05-21 12:18:45 +03:00
assets/img docs: add readme 2025-05-21 12:17:06 +03:00
lua feat: add icon 2025-05-21 12:03:48 +03:00
.gitignore Initial commit 2025-05-21 09:47:46 +03:00
.luarc.json refactor: split into config/status/component modules 2025-05-21 11:55:50 +03:00
LICENSE Create LICENSE 2025-05-21 12:18:45 +03:00
neovim.yml Initial commit 2025-05-21 09:47:46 +03:00
README.md docs: add readme 2025-05-21 12:17:06 +03:00
selene.toml Initial commit 2025-05-21 09:47:46 +03:00
stylua.toml Initial commit 2025-05-21 09:47:46 +03:00

lualine-harpoon.nvim

!assets/img/2025-05-21_12-16-25.webp

A tiny Lualine component for
ThePrimeagen/harpoon2.
Displays your current Harpoon mark as [x/y] in your statusline.

Requirements

Important

Make sure to install harpoon2, not harpoon on master branch.

Installation

Using lazy.nvim

{
  "nvim-lualine/lualine.nvim",
  dependencies = {
    "kristoferssolo/lualine-harpoon.nvim",
    dependencies = {
      { "ThePrimeagen/harpoon", branch = "harpoon2" }
      "nvim-lua/plenary.nvim",
    },
  },
}

Basic Usage

Once installed, simply add "harpoon" to your lualine.setup sections.
Lualine will auto-load lua/lualine/components/harpoon.lua for you:

require("lualine").setup({
  sections = {
    lualine_c = {
      "harpoon",
    },
  },
})

When you have Harpoon marks, youll see an indicator like [2/5] in your statusline.

Configuration

You can override plugin-wide defaults before calling lualine.setup:

-- default configs
require("lualine-harpoon").setup({
  symbol = {
    open = "[",
    close = "]",
    separator = "/",
    unknown = "?",
  },
  icon = "󰀱",
})

Per-component Overrides

You can also pass options directly in your Lualine sections:

require("lualine").setup({
  sections = {
    lualine_c = {
      {
        "harpoon",
        symbol = { open = "<", close = ">" },
      },
    },
  },
})

Acknowledgments and alternatives

This plugin was inspired by and serves as an alternative to letieu/harpoon-lualine.

License

This project is licensed under the MIT License - see the LICENSE file for details.