kitty-navigator.txt

*kitty-navigator.txt* Plugin to allow seamless navigation between kitty and vim

==============================================================================
CONTENTS                               *kitty-navigator-contents*


==============================================================================
INTRODUCTION                           *kitty-navigator*

Vim-kitty-navigator is a little plugin which enables seamless navigation
between kitty panes and vim splits. This plugin is a repackaging of Mislav
Marohinc's tmux=navigator configuration. When combined with a set of kitty key
bindings, the plugin will allow you to navigate seamlessly between vim and
kitty splits using a consistent set of hotkeys.

NOTE: This requires kitty v0.13.1 or higher.

==============================================================================
CONFIGURATION                             *kitty-navigator-configuration*

* Custom Key Bindings
 let g:kitty_navigator_no_mappings = 1

 nnoremap <silent> {Left-mapping} :KittyNavigateLeft<cr>
 nnoremap <silent> {Down-Mapping} :KittyNavigateDown<cr>
 nnoremap <silent> {Up-Mapping} :KittyNavigateUp<cr>
 nnoremap <silent> {Right-Mapping} :KittyNavigateRight<cr>
 nnoremap <silent> {Previous-Mapping} :KittyNavigatePrevious<cr>

* Navigating In Stacked Layout
let g:kitty_navigator_enable_stack_layout = 1

By default `vim-kitty-navigator` prevents navigating to "hidden" windows while in
stacked layout. This is to prevent accidentally switching to a window that is
"hidden" behind the current window. The default behavior can be overridden by 
setting the `kitty_navigator_enable_stack_layout` option to 1.

 vim:tw=78:ts=8:ft=help:norl: