Document the new command palette

This commit is contained in:
Kovid Goyal 2026-03-03 15:34:10 +05:30
parent 5638d20921
commit baca6acdc7
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
5 changed files with 14 additions and 3 deletions

View file

@ -8,4 +8,7 @@ using the ``map`` and ``mouse_map`` directives in :file:`kitty.conf`. For
configuration examples, see the default shortcut links for each action.
To read about keyboard mapping in more detail, see :doc:`mapping`.
You can also browse and trigger these actions by pressing :sc:`command_palette`
to run the command palette.
.. include:: /generated/actions.rst

View file

@ -167,6 +167,9 @@ Detailed list of changes
- Allow dragging window borders to resize kitty windows in all the different
layouts, controlled by :opt:`window_drag_tolerance` (:pull:`9447`)
- A command palette to browse and trigger all mapped and unmapped actions
(:pull:`9545`)
- choose-files kitten: Fix JXL image preview not working (:iss:`9323`)
- Fix tab bar rendering glitches when using :opt:`tab_bar_filter` in some

View file

@ -3836,8 +3836,9 @@ Some quick examples to illustrate common tasks::
# multi-key shortcuts
map ctrl+x>ctrl+y>z action
The full list of actions that can be mapped to key presses is available
:doc:`here </actions>`.
You can browse and trigger these actions by pressing :sc:`command_palette` to
run the command palette. The full list of actions that can be mapped to
key presses is available :doc:`here </actions>`.
''')
opt('kitty_mod', 'ctrl+shift',
@ -4532,6 +4533,9 @@ agr('shortcuts.misc', 'Miscellaneous')
map('Show documentation',
'show_kitty_doc kitty_mod+f1 show_kitty_doc overview')
map('Command palette',
'command_palette kitty_mod+f3 command_palette')
map('Toggle fullscreen',
'toggle_fullscreen kitty_mod+f11 toggle_fullscreen',
)

View file

@ -959,6 +959,8 @@ defaults.map = [
KeyDefinition(is_sequence=True, trigger=SingleKey(mods=256, key=112), rest=(SingleKey(key=121),), definition='kitten hints --type hyperlink'),
# show_kitty_doc
KeyDefinition(trigger=SingleKey(mods=256, key=57364), definition='show_kitty_doc overview'),
# command_palette
KeyDefinition(trigger=SingleKey(mods=256, key=57366), definition='command_palette'),
# toggle_fullscreen
KeyDefinition(trigger=SingleKey(mods=256, key=57374), definition='toggle_fullscreen'),
# toggle_maximized

View file

@ -167,7 +167,6 @@ def detach_tab_parse(func: str, rest: str) -> FuncArgsType:
@func_with_args(
'set_background_opacity', 'goto_layout', 'toggle_layout', 'toggle_tab', 'kitty_shell', 'show_kitty_doc',
'set_tab_title', 'push_keyboard_mode', 'dump_lines_with_attrs', 'set_window_title', 'simulate_color_scheme_preference_change',
'command_palette',
)
def simple_parse(func: str, rest: str) -> FuncArgsType:
return func, (rest,)