popup.kak
Kakoune popups for running ephemeral commands.
Demo
Installation
Prerequisites
tmux must be installed. It is not required that kakoune runs under tmux, just that it's installed.
Recommended
- Install the binary with
cargo install kak-popup.
- Add
evaluate-commands %sh{kak-popup init} to your kakrc.
Manual
- Install the plugin using nix or manually place
rc/popup.kak into your autoload directory.
- Install
kak-popup with cargo or nix.
Usage
Within kakoune
```
popup [] ...: create a modal running
in a terminal. Switches are prefixed with --. The command
and arguments can be passed as a single string or as a series of arguments,
for example, the following two invocations are equivalent:
popup --title open %{fish -c "some fish command"}
popup --title open -- fish -c "some fish command"
Popups can be exited using .
Switches:
--kak-script kakoune script to execute after the shell-command
exits, providing any standard output through
%opt{popupoutput}
--title the title of the modal
--input <input> input passed as the stdin of <shell-command>
--on-err <on-err> what to do on non-zero exit status
warn show a modal with stderr
dismiss dismiss modal without running KAK</em>SCRIPT
ignore ignore status and always run KAK_SCRIPT
```</p>
<h2>Examples</h2>
<p>These are some possible ways to use popup.kak:</p>
<p>```kak</p>
<h1>open a shell</h1>
<p>popup fish</p>
<h1>a file picker</h1>
<p>popup --title open --kak-script %{edit %opt{popup_output}} -- fzf
```</p>
</body></html>