Kitty вместо iTerm: конфиг целиком в git, startup sessions и грабли с tmux по ssh

Wed, 25 Feb 2026 16:30:00 +0500

Я давно привык, что всё настраивается файлом: vim, tmux, zsh, docker-compose — конфиг лежит в git, правится руками, переносится на новую машину за минуту. iTerm на этом фоне всегда стоял особняком: кликаешь по меню, идёшь в Preferences, настраиваешь мышкой.

Ниже — почему я переехал на Kitty, что именно в конфиге и на какой ерунде я потерял вечер.

Почему именно iTerm перестал устраивать

Сразу оговорюсь: iTerm не плохой. Он стабильный, у него отличный поиск по скроллбеку, и большинству людей его хватает с запасом.

Дальше идёт возражение, которое я слышу каждый раз: «настройки iTerm тоже можно держать в git, есть же экспорт в plist». Формально — да. Практически это выглядит так:

New Bookmarks

    
        ASCII Anti Aliased
        
        Non Ascii Font
        Monaco 12
        ...

Проблема не в том, что файла нет. Проблема в том, что этот файл:

не читается глазами — чтобы понять, что поменялось, нужен diff по XML-структуре, а не по смыслу;
не комментируется — нельзя написать рядом «поставил 120%, иначе глаза устают»;
не мержится — конфликт в plist на двух машинах разруливается вручную и болезненно;
не правится руками — редактируешь всё равно через GUI, plist только выгружаешь.

То есть это не конфиг, а дамп состояния. Разница примерно как между docker-compose.yml и снапшотом контейнера.

У Kitty конфиг — обычный текстовый файл с комментариями, который перезагружается без рестарта.

Вау-момент: startup sessions

Момент, после которого я перестал сомневаться.

Kitty умеет описывать стартовое состояние окна отдельным файлом. Не скриптом, не набором alias — обычным конфигом:

os_window_state maximized

new_tab Back console
cd ~/Develop/some_app
launch zsh

new_tab Back Claude
cd ~/Develop/some_app
launch zsh -ic "claude; exec zsh"

Путь указывается в основном конфиге:

startup_session ~/.config/kitty/sessions/myapp.conf

Запускаю Kitty — окно разворачивается на весь экран (именно maximized, с доком и менюбаром, а не fullscreen), открываются две вкладки: сервис в нужной директории и рядом Claude для того же сервиса. Ноль ручных действий.

Под каждый проект — свой файл сессии. Всё в git.

Настройки, которые стоит объяснить

Полный конфиг я приложил в конце. Здесь — только то, что не очевидно из названия параметра.

Сплиты вместо tmux для локальной работы

enabled_layouts splits:split_axis=horizontal,fat,tall,stack

map f5 launch --location=hsplit --cwd=current
map f6 launch --location=vsplit --cwd=current
map ctrl+shift+z toggle_layout stack

Ключевое здесь — --cwd=current: новый сплит открывается в той же директории, а не в домашней. Именно это убрало у меня необходимость в tmux для локальных сессий — раньше tmux был нужен ровно за панели.

ctrl+shift+z разворачивает текущий сплит на всё окно и возвращает обратно, аналог tmux resize-pane -Z. Остальные панели никуда не деваются.

Уведомление о долгой команде

notify_on_cmd_finish invisible 30

Самая недооценённая настройка. Если команда шла дольше 30 секунд и окно в этот момент неактивно — прилетит системное уведомление. Ушёл читать почту, пока идёт билд — тебя позовут.

Слово invisible важно: уведомление приходит только когда окно не на виду. Иначе бы дёргало на каждый go build.

Shell integration и remote control

allow_remote_control yes
shell_integration    enabled

shell_integration даёт то, чего в терминалах обычно нет: Kitty начинает понимать, где кончается вывод одной команды и начинается другая. Отсюда прыжки по промптам и подсветка границ вывода.

allow_remote_control открывает управление из скриптов — kitty @ launch, kitty @ set-tab-title и прочее. Нужно, если собираешься автоматизировать раскладку окон. Если не собираешься — лучше не включать: это всё-таки открытый сокет управления терминалом.

Мелочи, которые я выбрал под себя

modify_font cell_height 120%
scrollback_lines 10000
copy_on_select yes

cell_height 120% — больше воздуха между строками. Чисто вопрос глаз, кому-то покажется разреженно.

scrollback_lines 10000 — мне столько хватает, чтобы отлистать вывод неудачного деплоя целиком. Гоняешь очень болтливые логи — ставь больше, память там копеечная.

copy_on_select — выделил, уже в буфере. Привычка из Linux, на macOS сначала непривычно.

Nerd Font (JetBrainsMono Nerd Font Mono) нужен не сам по себе, а если у тебя starship, neovim с иконками или powerline-таббар — без него вместо иконок будут квадраты.

Что реально поломалось: tmux по ssh

Единственная настоящая проблема за всё время.

При подключении по ssh на машину, где живёт tmux, ломались escape-последовательности: съезжали цвета, мусорились рамки, местами не работали клавиши. Причина в том, что Kitty представляется как TERM=xterm-kitty, а на удалённой машине такого terminfo нет — она просто не знает, что это за терминал.

Правильное решение оказалось встроенным: kitty +kitten ssh сам доставляет terminfo на удалённый хост перед подключением.

# ~/.zshrc
[ "$TERM" = "xterm-kitty" ] && alias ssh="kitty +kitten ssh"

Проверка $TERM тут не для красоты: без неё alias сломает ssh во всех остальных терминалах — в том же VS Code или в CI-шелле, где kitty в PATH может и не быть.

После этого проблема ушла полностью.

Альтернатива, если kitten ssh почему-то не подходит — прописать TERM=xterm-256color перед подключением. Работает, но теряются возможности, за которые Kitty и брали.

Полный `kitty.conf`

Конфиг целиком, с комментариями

Tmux on Блог Сергея Клюкина