Repository navigation
Configuration
github-actions[bot] edited this page Nov 11, 2026
·
1 revision
require("bufferlines").setup(config) is not an incremental options update. Each
call receives a complete configuration. Keep your original table around so you can
restore settings later without losing custom options or highlights:
local bufferlines = require("bufferlines")
local original_config = {
options = {
-- Keep all your existing options here.
},
-- Keep other setup fields, such as highlights, here too.
}
bufferlines.setup(original_config)This matters most when toggling the multiline renderer, which has native-only options you must remove from the multiline copy and restore afterwards.
The full option table, defaults, types and validation rules are in the generated help
file, which is authored in wiki/help/:
:help bufferlines-configurationTopic-specific reference pages:
| Topic | Help tag |
|---|---|
| Hover events | :help bufferlines-hover-events |
| Styling and presets |
:help bufferlines-styling, :help bufferlines-style-presets
|
| Tabpages | :help bufferlines-tabpages |
| Numbers | :help bufferlines-numbers |
| LSP diagnostics | :help bufferlines-diagnostics |
| Groups | :help bufferlines-groups |
| Sorting and filtering |
:help bufferlines-sorting, :help bufferlines-filtering
|
| Commands | :help bufferlines-commands |
| Custom functions | :help bufferlines-functions |
| Pick | :help bufferlines-pick |
| Mappings | :help bufferlines-mappings |
| Highlights | :help bufferlines-highlights |
| Mouse actions | :help bufferlines-mouse-actions |
| Custom areas | :help bufferlines-custom-areas |
| Sidebar offsets | :help bufferlines-sidebar-offset |
Read AGENTS.md for
architecture, offline tests, compatibility boundaries and safe development workflows.
CLAUDE.md imports that shared guide for Claude Code.
English
Getting started
Reference
Development