nvim-kitty-navigator

Navigate seamlessly between Kitty and Neovim windows.

This kitten is inspired by vim-tmux-navigator and vim-kitty-navigator.

Unlike its inspirations, nvim-kitty-navigator doesn't require a Neovim plugin. Instead, pynvim is used to control Neovim programatically. As a result, enabling remote control for kitty is not required!

Installation

This script requires pynvim:

pip install pynvim

Then download the kitten to ~/.config/kitty/.

curl https://raw.githubusercontent.com/ouroboros8/nvim-kitty-navigator/main/navigate.py -o ~/.config/kitty/navigate.py

Configuration

Add the following (changing the mappings to whatever you like!) to your kitty.conf:

map ctrl+h kitten navigate.py left
map ctrl+j kitten navigate.py down
map ctrl+k kitten navigate.py up
map ctrl+l kitten navigate.py right

Notes

The kitten makes a couple of assumptions about your neovim setup:

1. It expects Neovim to create a default RPC socket in its runpath at startup, as described in the API docs.
2. It expects the socket to have a predictable name in the format nvim.<pid>.<n>
3. It expects the standard runpath not to change from one vim instance to another, or over the life of a Kitty process. The path is discovered by running :echo stdpath('run') on a headless Neovim instance, then cached until Kitty exits.

In summary, if you're using a non-standard Neovim RPC setup (for example, using --listen for TCP RCP), this kitten will probably not work for you. If you think it could/should, please feel free to raise an issue with details of your setup! :)