kakoune

= image:{logo}[K,32,32,link="{website}",title="Kakoune logo by p0nce"] Kakoune image:{cirrus-img}[link="{cirrus-url}"] image:{srht-img}[link="{srht-url}"] image:{irc-img}[link="{irc-url}"]
ifdef::env-github,env-browser[:outfilesuffix: .asciidoc]
:logo: http://kakoune.org/img/kakoune_logo_32.png
:website: https://kakoune.org
:cirrus-img: https://api.cirrus-ci.com/github/mawww/kakoune.svg
:cirrus-url: https://cirrus-ci.com/github/mawww/kakoune
:srht-img: https://builds.sr.ht/~mawww/kakoune.svg
:srht-url: https://builds.sr.ht/~mawww/kakoune?
:irc-img: https://img.shields.io/badge/IRC-%23kakoune-blue.svg
:irc-url: https://web.libera.chat/?channels=kakoune
:icons: font
:toc: right
:pp: ++

TL;DR
-----

{website}

*Modal editor* -- *Faster as in fewer keystrokes* --
*Multiple selections* -- *Orthogonal design*

---------------------------------------------
git clone https://github.com/mawww/kakoune.git
cd kakoune
make
./src/kak
---------------------------------------------

See https://github.com/mawww/golf for Kakoune solutions to vimgolf challenges,
regularly beating the best Vim solution.

See the link:doc/design.asciidoc[design document] for more information on
Kakoune's philosophy and design.

Introduction
------------

Kakoune is a code editor that implements Vi's "keystrokes as a text editing
language" model. As it is also a modal editor, it is somewhat similar to the
Vim editor (after which Kakoune was originally inspired).

Kakoune can operate in two modes: *normal* and *insertion*. In insertion mode,
keys are directly inserted into the current buffer. In normal mode, keys
are used to manipulate the current selection and to enter insertion mode.

Kakoune has a strong focus on interactivity. Most commands provide immediate
and incremental results, while being competitive with Vim in terms of keystroke count.

Kakoune works on selections, which are oriented, inclusive ranges of characters.
Selections have an anchor and a cursor. Most commands move both of
them except when extending selections, where the anchor character stays fixed
and the cursor moves around.

See https://vimeo.com/82711574

Join us on libera IRC `#Kakoune`

Features
~~~~~~~~

 * Multiple selections as a central way of interacting
 * Powerful selection manipulation primitives
   - Select all regex matches in current selections
   - Keep selections containing/not containing a match for a given regex
   - Split current selections with a regex
   - Text objects (paragraph, sentence, nestable blocks)
 * Powerful text manipulation primitives
   - Align selections
   - Rotate selection contents
   - Case manipulation
   - Indentation
   - Piping each selection to external filter
 * Client-Server architecture
   - Multiple clients on the same editing session
   - Use tmux, zellij, kitty, wezterm or your X11/Wayland window manager to
     manage splits/panes by spawning clients connected to the same session
 * Simple interaction with external programs
 * Automatic contextual help
 * Au