Beargruug/skipper.nvim

github

marks

7

0

2

0

CREATED

2024-02-23

UPDATED

2026-02-11

---

Skipper.nvim

A lightweight Neovim plugin for fast function navigation using Tree-sitter.

Demo

https://github.com/user-attachments/assets/b539c3cb-654c-435e-98ed-11bc93823e1a

Features

• Fast function navigation - Open a popup window listing all functions in the current file
• Tree-sitter powered - Accurate parsing across multiple languages
• Jump to definition - Select a function and instantly jump to its location
• Minimal UI - Clean floating window that doesn't interrupt your workflow
• Customizable - Configure window size, border style, and title

Supported Languages

Requirements

• Neovim >= 0.5.0
• nvim-treesitter with parsers installed for your languages

Installation

lazy.nvim

{
    "beargruug/skipper.nvim",
    dependencies = { "nvim-treesitter/nvim-treesitter" },
    config = function()
        require("skipper").setup()
    end,
}

vim-plug

Plug 'nvim-treesitter/nvim-treesitter'
Plug 'beargruug/skipper.nvim'

Then add to your config:

require("skipper").setup()

packer.nvim

use {
    "beargruug/skipper.nvim",
    requires = { "nvim-treesitter/nvim-treesitter" },
    config = function()
        require("skipper").setup()
    end,
}

Configuration

Skipper.nvim comes with sensible defaults, but you can customize it:

require("skipper").setup({
    win_width = 120,   -- Width of the floating window
    win_height = 20,   -- Height of the floating window
})

Usage

Commands

Keymaps

Add a keymap to quickly open the function window:

vim.keymap.set("n", "<leader>cf", "<cmd>ShowFunctionsWindow<CR>", { desc = "Show functions" })

Or call the Lua API directly:

vim.keymap.set("n", "<leader>cf", function()
    require("skipper").show_functions_window()
end, { desc = "Show functions" })

Window Controls

Once the function window is open:

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Status

Skipper.nvim is under active development. Feedback, issue reports, and pull requests are always welcome.

License

MIT