Struct KeyBindings 

pub struct KeyBindings { /* private fields */ }

Complete keybindings configuration.

Implementations

impl KeyBindings

pub fn new() -> Self

Create keybindings with default bindings.

pub fn load(path: &Path) -> Result<Self, Error>

Load keybindings from a JSON file, merging with defaults.

pub fn user_config_path() -> PathBuf

Get the default user keybindings path: ~/.pi/agent/keybindings.json

pub fn load_from_user_config() -> KeyBindingsLoadResult

Load keybindings from user config, returning defaults with diagnostics if loading fails.

This method never fails - it always returns valid keybindings (defaults at minimum). Warnings are collected in KeyBindingsLoadResult for display to the user.

User Config Format

The config file is a JSON object mapping action IDs (camelCase) to key bindings:

{
  "cursorUp": ["up", "ctrl+p"],
  "cursorDown": ["down", "ctrl+n"],
  "deleteWordBackward": ["ctrl+w", "alt+backspace"]
}

pub fn load_from_path_with_diagnostics(path: &Path) -> KeyBindingsLoadResult

Load keybindings from a specific path with full diagnostics.

Returns defaults with warnings if:

• File doesn’t exist (no warning - this is normal)
• File is not valid JSON
• File contains unknown action IDs
• File contains invalid key strings

pub fn lookup(&self, binding: &KeyBinding) -> Option<AppAction>

Look up the action for a key binding.

pub fn matching_actions(&self, binding: &KeyBinding) -> Vec<AppAction>

Return all actions bound to a key binding.

Many bindings are context-dependent (e.g. ctrl+d can mean “delete forward” in the editor but “exit” when the editor is empty). Callers should resolve collisions based on UI state.

pub fn get_bindings(&self, action: AppAction) -> &[KeyBinding]

Get all key bindings for an action.

pub fn iter(&self) -> impl Iterator<Item = (AppAction, &[KeyBinding])>

Iterate all actions with their bindings (for /hotkeys display).

pub fn iter_category( &self, category: ActionCategory, ) -> impl Iterator<Item = (AppAction, &[KeyBinding])>

Iterate actions in a category with their bindings.

Trait Implementations

impl Clone for KeyBindings

fn clone(&self) -> KeyBindings

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KeyBindings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for KeyBindings

fn default() -> Self

Returns the “default value” for a type.