kakoune.cr (kcr) is a command-line tool for Kakoune.

It is a great companion to work with projects, multiple files and headless sessions.

• Connect applications to Kakoune.
• Control Kakoune from the command-line.
• Manage sessions.
• Write plugins.

Give it a spin: kcr tldr & kcr play.

See what’s new with kcr -V | kcr --version-notes or read the changelog.

kakoune.cr is based around the concept of contexts, which can be set via the --session and --client options.

For example, the following command will open the file in the main client of the kanto session.

kcr edit --session=kanto --client=main pokemon.json

Most of the time, you don’t need to specify them. connect will forward KAKOUNE_SESSION and KAKOUNE_CLIENT environment variables, which will be used by kcr to run commands in the specified context.

Example – Connect a terminal:

connect terminal

Example – Connect a program:

connect run alacritty

• Crystal
• Shards
• jq

Download the Nightly builds.

Run the following in your terminal:

make install

Add the Kakoune definitions to your kakrc.

evaluate-commands %sh{
  kcr init kakoune
}