https://github.com/enricozb/tabs.kak

Kakoune buffers as tabs in the status line.
https://github.com/enricozb/tabs.kak

kakoune plugin

Last synced: about 2 months ago
JSON representation

Kakoune buffers as tabs in the status line.

• Host: GitHub
• URL: https://github.com/enricozb/tabs.kak
• Owner: enricozb
• Created: 2020-11-20T05:10:48.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-11-07T21:07:30.000Z (11 months ago)
• Last Synced: 2024-04-23T22:54:43.255Z (5 months ago)
• Topics: kakoune, plugin
• Language: Rust
• Homepage:
• Size: 2.9 MB
• Stars: 20
• Watchers: 2
• Forks: 3
• Open Issues: 4
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# tabs.kak

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

## Demo

[![asciicast](https://asciinema.org/a/uAg0yrrrafPQVCowu23ISqRUp.svg)](https://asciinema.org/a/uAg0yrrrafPQVCowu23ISqRUp)

## 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' -docstring 'tabs'

  map global normal B ': enter-user-mode -lock tabs' -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

```kak

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

1. Install the [`rc/tabs.kak`](./rc/tabs.kak) so your kakoune instance auto-loads it.

2. Install the [kak-tabs](https://crates.io/crates/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: 



> Originally inspired by [Delapouite's `kakoune-buffers`][1].

> **Warning**

> This plugin is **incompatible** with [powerline.kak][2], see [here][3] for why.

[1]: https://github.com/Delapouite/kakoune-buffers/

[2]: https://github.com/andreyorst/powerline.kak

[3]: https://github.com/enricozb/tabs.kak/issues/1#issuecomment-737410152