mirrors/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty synced 2026-06-08 14:18:26 +02:00
Code Issues Packages Projects Releases Wiki Activity

Document the new command palette

Browse Source
This commit is contained in:
Kovid Goyal
2026-03-03 15:34:10 +05:30
parent 5638d20921
commit baca6acdc7
5 changed files with 14 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
docs/actions.rst
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. configuration examples, see the default shortcut links for each action.
To read about keyboard mapping in more detail, see :doc:`mapping`. 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 .. include:: /generated/actions.rst

3
docs/changelog.rst
View File

@@ -167,6 +167,9 @@ Detailed list of changes
- Allow dragging window borders to resize kitty windows in all the different - Allow dragging window borders to resize kitty windows in all the different
layouts, controlled by :opt:`window_drag_tolerance` (:pull:`9447`) 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`) - choose-files kitten: Fix JXL image preview not working (:iss:`9323`)
- Fix tab bar rendering glitches when using :opt:`tab_bar_filter` in some - Fix tab bar rendering glitches when using :opt:`tab_bar_filter` in some

8
kitty/options/definition.py
View File

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

2
kitty/options/types.py generated
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'), KeyDefinition(is_sequence=True, trigger=SingleKey(mods=256, key=112), rest=(SingleKey(key=121),), definition='kitten hints --type hyperlink'),
# show_kitty_doc # show_kitty_doc
KeyDefinition(trigger=SingleKey(mods=256, key=57364), definition='show_kitty_doc overview'), 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 # toggle_fullscreen
KeyDefinition(trigger=SingleKey(mods=256, key=57374), definition='toggle_fullscreen'), KeyDefinition(trigger=SingleKey(mods=256, key=57374), definition='toggle_fullscreen'),
# toggle_maximized # toggle_maximized

1
kitty/options/utils.py
View File

@@ -167,7 +167,6 @@ def detach_tab_parse(func: str, rest: str) -> FuncArgsType:
@func_with_args( @func_with_args(
'set_background_opacity', 'goto_layout', 'toggle_layout', 'toggle_tab', 'kitty_shell', 'show_kitty_doc', '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', '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: def simple_parse(func: str, rest: str) -> FuncArgsType:
return func, (rest,) return func, (rest,)