List Karabiner-Elements complex modification rules for a profile.

Returns each rule's description, enabled/disabled status, whether it's installed in karabiner.json, and its source asset file. Rules are listed in priority order (first match wins in Karabiner).

Create and install a new Karabiner-Elements rule.

Writes the rule to an asset file AND installs it in karabiner.json for immediate effect. Karabiner-Elements auto-reloads on file change.

For simple remaps, use to_key_code. For tap-vs-hold, combine to_key_code (held behavior) with to_if_alone_key_code (tap behavior).

Examples:

• Simple remap (caps->esc): from_key_code="caps_lock", to_key_code="escape"

• With modifier (ctrl+h->backspace): from_key_code="h", from_mandatory_modifiers=["control"], to_key_code="delete_or_backspace"

• Tap/hold (caps: tap=esc, hold=ctrl): from_key_code="caps_lock", to_key_code="left_control", to_if_alone_key_code="escape"

• App-specific: add app_if=['^com.apple.Terminal$']

• Shell command: from_key_code="f5", to_shell_command="open -a Safari"

Enable or disable an installed rule.

The rule stays in karabiner.json either way — disabling adds 'enabled: false', enabling removes that flag.

Remove a rule from karabiner.json (all profiles).

By default the asset file is preserved so the rule can be re-added later via the Karabiner Settings UI or add_rule.

Edit an existing rule. Updates both the asset file and karabiner.json. Only pass the parameters you want to change.

To see a rule's current configuration, use list_rules first.

List all Karabiner-Elements profiles with their rule counts.

Shows which profile is currently selected. Use select_profile to switch the active profile.

Switch the active Karabiner-Elements profile.

Takes effect immediately. Use list_profiles first to see available profiles and their indices.

Search valid Karabiner-Elements key codes and modifiers.

Call this before add_rule or edit_rule to find the correct key_code string. Key codes are Karabiner-specific identifiers (e.g. 'return_or_enter' not 'enter', 'delete_or_backspace' not 'backspace', 'grave_accent_and_tilde' not '`').