tabs.kak

View open buffers in status line, like tabs, and navigate between them quickly.

Demo

Keybindings

The recommended key bindings can be set by calling tabs-recommended-keys:

define-command tabs-recommended-keys -docstring "set the recommended kak-tabs bindings" %{
  map global normal q b
  map global normal Q B
  map global normal b ': enter-user-mode tabs<ret>' -docstring 'tabs'
  map global normal B ': enter-user-mode -lock tabs<ret>' -docstring 'tabs (lock)'
}

Within the tabs mode, the keybindings are as follows:

a: ↔ (alternate)      return to the previously focused buffer
h: ← (previous)       navigate to the buffer on the left
l: → (next)           navigate to the buffer on the right
s:   (*scratch*)      open the *scratch* buffer
u:   (*debug*)        open the *debug* buffer
H: ← (drag left)      swap this buffer to the left
L: → (drag right)     swap this buffer to the right
d:   (delete current) delete the current buffer

Configuration

Example Configuration

set-option global tabs_modelinefmt '%val{cursor_line}:%val{cursor_char_column} {{mode_info}} '
set-option global tabs_options --minified

Options

tabs_modelinefmt: when set to a modelinefmt string, it is placed in the space preceding the tabs
tabs_options: a list of switches that affect tabs' appearance.
- --minified
- this will cause tabs to show as little of their paths as possible while still being unique. For example, if the currently open buffers are
```
projects/1/src/main.rs projects/2/src/main.rs projects/2/Cargo.toml
```
  then the rendered tabs will be
```
| 1/src/main.rs | 2/src/main.rs | Cargo.toml |
```
  because these are the smallest unique suffixes of each buffer.

Installation

Install the rc/tabs.kak so your kakoune instance auto-loads it.
Install the kak-tabs rust crate.

TODO

the order of tabs changes how the disambiguation of files with the same names work. for example:
- we have a buflist that looks like:
- | *debug* | xml.rs | pypi/mirror/mod.rs | cargo/mirror/mod.rs | mod.rs |
- swapping the last two buffers yields the following tabs:
- | *debug* | xml.rs | mirror/mod.rs | api/mod.rs | mod.rs |
tabs should shrink when there's not enough space
add more buffer deletion options, see: https://github.com/enricozb/tabs.kak/issues/3

Originally inspired by Delapouite's kakoune-buffers.

Warning This plugin is incompatible with powerline.kak, see here for why.

enricozb / tabs.kak

readme