popup.kak

Kakoune popups for running ephemeral commands.

Demo

asciicast

Installation

Prerequisites

tmux must be installed.

Recommended

  1. Install the binary with cargo install kak-popup.
  2. Add evaluate-commands %sh{kak-popup init} to your kakrc.

Manual

  1. Install the plugin using nix or manually place rc/popup.kak into your autoload directory.
  2. 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 --on</em>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</em>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>