Try or ByeTry or Bye

Neovim Escape Key Delay in tmux

Workaround available macOS, Linux Updated October 21, 2026

Quick answer

A noticeable lag when pressing Esc to leave insert mode inside tmux comes from tmux's escape-time. Lower it to about 10ms.

Most likely fix: Lower tmux escape-time.

Symptoms

Leaving insert mode feels slow only inside tmux or GNU screen; :checkhealth flags escape-time.

Why it happens

  • tmux waits to see if Esc starts a key sequence
  • GNU screen maptimeout too high

How to fix it

Try these in order — the most common fix is first.

  1. 1. Lower tmux escape-time

    1. Add set -sg escape-time 10 to ~/.tmux.conf (tmux 2.6+)
    2. Reload: tmux source-file ~/.tmux.conf

  2. 2. GNU screen

    1. Add maptimeout 10 to ~/.screenrc
    2. With screen mouse mode on, Esc can be lost; press it twice as a workaround

This guide also covers

  • neovim escape delay tmux
  • nvim esc slow
  • tmux escape-time neovim

Still not working?

If Neovim keeps failing, you're not alone. See every Neovim problem users report or the alternatives people switch to.

Other Neovim errors