Skip to content

alexherbo2/kakoune.cr

Repository files navigation

kakoune.cr

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

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

Thumbnail Button

What can I do?
  • 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.

How does it work?

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

Dependencies

Installation

Nightly builds

Download the Nightly builds.

Build from source

Run the following in your terminal:

make install

Kakoune definitions

Add the Kakoune definitions to your kakrc.

evaluate-commands %sh{
  kcr init kakoune
}