function fish_user_key_bindings
    # Vi mode first: it rebinds the preset tables and (on first activation)
    # re-triggers this function via the fish_key_bindings handler, so custom
    # binds must come after it to land on top.
    fish_vi_key_bindings

    # Vi mode types in `insert`; bind customs there AND in `default` (normal)
    # so the keys work regardless of mode.
    for mode in insert default
        # Keys owned by kitty.conf never reach fish and are NOT bound here:
        #   ctrl-g → lazygit overlay, ctrl-a → omp hsplit, ctrl-y → yazi vsplit,
        #   ctrl-h/j/k/l → vim-aware split nav (pass_keys.py).
        # ctrl-e: yazi, same as ctrl-f (cd's to yazi's exit dir on quit).
        bind -M $mode ctrl-e 'yy; commandline -f repaint'
        bind -M $mode ctrl-b purple repaint
        bind -M $mode ctrl-y clip-last

        bind -M $mode ctrl-o 'gho; commandline -f repaint'
        bind -M $mode ctrl-p 'pj; commandline -f repaint'
        bind -M $mode ctrl-a 'omp; commandline -f repaint'

        # ctrl-f: pick file(s) with television and open in nvim.
        bind -M $mode ctrl-f 'yy; commandline -f repaint'
        bind -M $mode ctrl-g 'lazygit; commandline -f repaint'

        # ctrl-c routes through the clear wrapper (kitty scrollback + prompt
        # pinned to the bottom) AND wipes any text typed on the command line.
        bind -M $mode ctrl-c 'commandline -r ""; clear; commandline -f repaint'

        # ctrl-q mirrors ctrl-d's preset (`exit`) — quit the shell.
        bind -M $mode ctrl-q exit
    end
end