AGENTS Instructions for `zpm-zsh---tmux-keys`

Purpose

Этот файл фиксирует рабочие договоренности по плагину tmux-keys: поведение конфигов, генерации, popup/exec и правила цветовых схем.

Конфиг клавиш должен искаться строго в таком порядке (первый существующий файл):

$XDG_CONFIG_HOME/tmux/keys.yaml (или ~/.config/tmux/keys.yaml, если XDG_CONFIG_HOME не задан)
~/.tmux/keys.yaml
~/.tmux-keys.yaml

Дополнительно:

tmux-keys.plugin.zsh и generate.py должны использовать один и тот же порядок.
Плагин передает выбранный путь в generate.py через TMUX_KEYS_CONFIG.
Если конфиг не найден ни в одном месте, создается пример в первом пути ($XDG_CONFIG_HOME/tmux/keys.yaml).

Кэш: ${TMPDIR:-/tmp}/zsh-${UID}/tmux-keys.zsh.
Кэш считается актуальным только если он новее:
- выбранного YAML-конфига
- generate.py
Иначе скрипт должен быть пересобран.

type: exec: команда отправляется в текущий pane и запускается с Enter через send-keys ... C-m.
- Не использовать литерал \n для Enter.
type: popup: запускать через tmux display-popup с рабочей директорией активного pane:
- -d "#{pane_current_path}"
Для долгих/шумных CLI-команд предпочтителен type: popup, чтобы не засорять командную строку текущего pane.

В примерах (tmux-keys.example.yaml, README snippet, fallback tmux-keys.example.zsh) применяем:

Цвета должны быть консистентными и предсказуемыми:

Кнопки одного типа действия могут иметь один цвет (пример: previous-window и next-window).
Кнопки-секции в главном меню (System, Git, Python, NPM, ZPM) должны быть разными между собой.
Кнопка Main во всех секциях должна иметь один и тот же цвет.
Цвет Main не должен совпадать с цветом previous/next.
Внутри каждой секции цвета кнопок должны быть разными.
Внутри секции не использовать цвет самой секции из главного меню.

При изменении логики обязательно синхронизировать: