fold_line.nvim

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 57 Open GitHub ↗

Lines indicating code folds.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# fold_line.nvim

This Neovim plugin uses lines to indicate code folding areas and highlights the current fold.

## Screenshots

The line of the current fold is yellow. You can change the color by setting the `FoldLineCurrent` highlight group.
<img width="960" alt="hi_current" src="https://github.com/user-attachments/assets/0fd67967-5dac-439d-9230-cc6538064e9e">

## Installation

Using [lazy.nvim](https://github.com/folke/lazy.nvim)

```lua
-- init.lua:
{
    "gh-liu/fold_line.nvim",
    event = "VeryLazy",
    init = function()
        -- change the char of the line, see the `Appearance` section
        vim.g.fold_line_char_open_start = "╭"
        vim.g.fold_line_char_open_end = "╰"
    end,
}
```

## Appearance

Use the highlight group `FoldLine` to change the color of the line. Per default it links to `Folded`.
And use the highlight group `FoldLineCurrent` to change the color of the line of current fold. Per default it links to `CursorLineFold`.

change the char of the line:
```lua
vim.g.fold_line_char_top_close = "+"        -- default: fillchars.foldclose or "+"
vim.g.fold_line_char_close = "├"            -- default: fillchars.vertright or "├"
vim.g.fold_line_char_open_sep = "│"         -- default: fillchars.foldsep or "│"
vim.g.fold_line_char_open_start = "╭"       -- default: "┌"
vim.g.fold_line_char_open_end = "╰"         -- default: "└"
vim.g.fold_line_char_open_start_close = "╒" -- default: "╒"
vim.g.fold_line_char_open_end_close = "╘"   -- default: "╘"
```

### Virtual text priority

Set the extmark priority before the plugin loads:

```lua
vim.g.fold_line_char_priority = 100 -- default: 100
```

The current fold uses this value plus one so that it takes precedence over other fold lines. Lower the value if fold lines overwrite diagnostics or virtual text from other plugins; raise it if fold lines should take precedence instead.

## Current fold only

To show lines for the current fold only, set `vim.g.fold_line_current_fold_only` to `true`.

## Bar position strategy

The “bar” is the rendered character (for example `│`, `┌`, `└`) drawn via virtual text.

You can control how its screen column is computed via `fold_line_bar_pos_strategy`:

- buffer-local: `vim.b.fold_line_bar_pos_strategy`
- window-local: `vim.w.fold_line_bar_pos_strategy`
- global: `vim.g.fold_line_bar_pos_strategy`

Priority: `b:` > `w:` > `g:` > default.

- `vim.g.fold_line_bar_pos_strategy = "indent"`: align bars to (fold start) indentation (legacy behavior).
- `vim.g.fold_line_bar_pos_strategy = "level"`: align bars by fold level (fixed step per level, like a foldcolumn).
- `vim.g.fold_line_bar_pos_strategy = "hybrid"`: prefer `"indent"`, but auto-degrade to `"level"` when foldmethod is `expr`/`syntax` (where indentation is often not meaningful).

If unset, it defaults to `"hybrid"`.

## Disabling

Set `vim.g.fold_line_disable` (globally) or `vim.w.fold_line_disable` (for a window) or `vim.b.fold_line_disable` (for a buffer) to `true`.

fold_line.nvim

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README