Skip to main content
  1. Posts/

Tmux: Open Terminal Failed in Kitty Terminal

··258 words·2 mins·
Mac Terminal Tmux
Table of Contents

I have several terminal emulators installed on my Mac: kitty, Alacritty and iterm2. When I start a Tmux session in Alacritty and try to create another tmux session in kitty, I noticed this strange error that I have never met before:

open terminal failed: missing or unsuitable terminal: xterm-kitty

For clarity, kitty seems to use its own terminfo file called xterm-kitty, and Alacritty and iterm2 both use the good-old xterm-256color.

The author of kitty claims that:

tmux does not support multiple terminfo. You will need to kill all existing tmux sessions and start a new one.

I find his claim to be partly true. If I create a session in Alacritty, I can not attach to this session or create new session in kitty. However, if I initially create a new session (before that, there is not tmux session running) in kitty, I can indeed attach to that session or create a new session in Alacritty.

My version info:

  • kitty: 0.17.2
  • Alacritty: 0.4.0
  • Tmux: 3.1b

So my temporary solution is to kill all sessions in other terminal emulators if you want to use tmux in kitty.

Tmux error when sshing to remote server
#

If you ssh to another server using kitty terminal and met this issue when starting tmux on that server. The reason may be that xterm-kitty terminfo file may not be available on that server. You can use the following command to copy the terminfo file to the remote server as indicate here:

kitty +kitten ssh myserver

References
#

Related

Setting up True Color Support for Neovim and Tmux on Mac
··687 words·4 mins
Mac Tmux Nvim Terminal
PATH Variable Changed inside Tmux on macOS?
·424 words·2 mins
Mac Shell Zsh Tmux
Kitty Terminal Config on Mac
··384 words·2 mins
Mac Terminal