z_mirror/kak-harpoon

git clone https://git.raiguard.me/z_mirror/kak-harpoon

Caleb HeuerUpdate readme388cd24

trunk
branchestrunkall refs →
1.3 KiB40 linesraw

kak-harpoon

Quickly save and switch between your most important Kakoune files. Harpoons are saved on editor shutdown and are restored depending on the current working directory and active Git branch of the session.

Inspired by Harpoon for Neovim.

asciicast

Installation

Source harpoon.kak in your kakrc, or use a plugin manager.

Usage

Call harpoon-add-bindings to add the default keybindings:

  • <user>h: Harpoon the current file
  • <user>H: View harpoons list
  • <a-1>: Navigate to the harpoon at position 1
  • <a-2>: Navigate to the harpoon at position 2
  • ...and so on up through <a-9>.

The harpoons list is an interactive buffer listing all of your current harpoons. You can freely edit or reorder this file, then call write to save it. The new order / contents will be set as your new harpoons. Press <esc> to close the harpoons list.

Customization

If the default bindings do not work for you, here are the relevant commands to call:

  • harpoon-add: Harpoon the current file
  • harpoon-nav <index>: Navigate to the harpoon at <index>
  • harpoon-show-list: View the harpoons list

Roadmap

  • Save line and column information
1# kak-harpoon
2
3Quickly save and switch between your most important Kakoune files. Harpoons are
4saved on editor shutdown and are restored depending on the current working
5directory and active Git branch of the session.
6
7Inspired by [Harpoon](https://github.com/ThePrimeagen/harpoon) for Neovim.
8
9[![asciicast](https://asciinema.org/a/MH4yLhuW5y4ryWQRxz7VZxD4Q.svg)](https://asciinema.org/a/MH4yLhuW5y4ryWQRxz7VZxD4Q)
10
11## Installation
12
13Source `harpoon.kak` in your `kakrc`, or use a plugin manager.
14
15## Usage
16
17Call `harpoon-add-bindings` to add the default keybindings:
18
19- `<user>h`: Harpoon the current file
20- `<user>H`: View harpoons list
21- `<a-1>`: Navigate to the harpoon at position 1
22- `<a-2>`: Navigate to the harpoon at position 2
23- ...and so on up through `<a-9>`.
24
25The harpoons list is an interactive buffer listing all of your current
26harpoons. You can freely edit or reorder this file, then call `write` to save
27it. The new order / contents will be set as your new harpoons. Press `<esc>` to
28close the harpoons list.
29
30## Customization
31
32If the default bindings do not work for you, here are the relevant commands to call:
33
34- `harpoon-add`: Harpoon the current file
35- `harpoon-nav <index>`: Navigate to the harpoon at `<index>`
36- `harpoon-show-list`: View the harpoons list
37
38## Roadmap
39
40- Save line and column information