Download
The vim-tmux-navigator plugin enables smooth and consistent navigation between splits within Vim (or Neovim) and panes in tmux, using a unified set of hotkeys. This means that instead of treating Vim splits and tmux panes as completely separate navigation domains, you can press the same directional keys (for example Ctrl-h / Ctrl-j / Ctrl-k / Ctrl-l) and move seamlessly between them. The plugin detects when you are at the edge of a Vim split and hands off navigation to tmux, or vice versa, enabling a more fluid multitasking workflow with terminal multiplexing and editing combined. Many terminal-based development setups rely on this plugin to unify the mental model of window/pane navigation across tools. It requires tmux version 1.8 or higher and a matching keybind configuration in tmux so that the plugin can hook into the navigation system. Users often find that it greatly reduces friction in workflows where they are switching back and forth between editor and terminal panes.
Features
- Unified keybindings for navigating Vim splits and tmux panes (ctrl-h/j/k/l)
- Automatic detection of when to switch between Vim and tmux contexts
- Minimal configuration required to get started
- Compatible with both Vim and Neovim (when used with tmux)
- Avoids the need to prefix tmux navigation with the tmux “leader” key
- Customisable mappings if default keys conflict with other settings
Project Samples
