keys_bypass

A WezTerm plugin to bypass specific keybindings for designated applications.

When a key combination is bypassed via this plugin, WezTerm will completely ignore both its internal and user-defined keybindings for that combination until the specified process is in the foreground of the pane or tab.

Installation

Add the following to your wezterm.lua:

-- Get plugin
local keys_bypass = wezterm.plugin.require 'https://github.com/KawaiiSelbst/keys_bypass.wez'

-- Example configuration
local keys_bypassConfig = {
    keys = {
        -- Where zellij is foreground process name
        zellij = {
            -- Key combinations that need to be bypassed
            { key = "q", mods = "CTRL" },
            { key = "k", mods = "CTRL" },
            { key = "h", mods = "CTRL|SHIFT" },
        },
        -- Where tmux is foreground process name
        tmux = {
            -- Key combinations that need to be bypassed
            { key = "b", mods = "CTRL" },
            { key = "q", mods = "ALT" },
            { key = "w", mods = "SHIFT" },
        },
    }
}

-- Plugin startup
keys_bypass.apply_to_config(config, keys_bypassConfig)