| name | change-keybinding |
| description | Customize Warp keyboard shortcuts (keybindings, keymappings) by editing the user's keybindings.yaml file. Use when the user asks to remap a key combination, rebind an action, change a shortcut, or remove a default keybinding (e.g. "change ctrl+space to ctrl+s", "rebind the command palette to cmd+p", "remove the default for X"). |
change-keybinding
Use this skill when the user wants to remap, rebind, or remove a Warp keyboard shortcut.
Keybindings file
User customizations live at:
{{keybindings_file_path}}
This is the exact path Warp reads at launch — it is platform- and channel-specific (e.g. under ~/.warp*/ on macOS, under XDG config dirs like ~/.config/warp-terminal/ on Linux, and under %LocalAppData% on Windows). Use this path verbatim — do not infer a different one from the user's home directory layout. Create the file (and any missing parent directories) if it does not exist.
File format
A flat YAML map of action_name → key_trigger. Action names contain a colon, so they must be quoted:
"workspace:toggle_ai_assistant": ctrl-s
"editor_view:delete_all_left": cmd-shift-A
"workspace:toggle_command_palette": none
Keystroke encoding rules
Triggers use Warp's normalized form — get this exactly right or the binding silently fails to load.
- Modifiers (in this order when combined):
ctrl-alt-shift-cmd-meta-. Cross-platform alias: cmdorctrl- (becomes cmd on macOS, elsewhere).
