popup.kak
Kakoune popups for running ephemeral commands.
Demo
Installation
Prerequisites
tmux must be 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{popup_output}
--title the title of the modal
--warn show stderr if exit status is non-zero
```</p>
<p>For example,
<code>
popup fish
</code>
will spawn a fish shell. For a simple file-picker:
<code>
popup --title open --kak-script %{edit %opt{popup_output}} fzf
</code></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>