KeyPath Documentation

Everything you need to master keyboard remapping on your Mac

New here? Start with Keyboard Concepts Jump to Installation

Getting Started

Install KeyPath and get your keyboard remapping in two minutes flat.

• Setting Up KeyPath
• Keyboard Concepts
• What You Can Build

Core Features

The essential features most people start with — home row mods, navigation layers, tap-hold, and quick tweaks.

• Shortcuts Without Reaching
• Vim Navigation
• Leader Key
• One Key, Multiple Actions
• Make Rules Work Together
• Quick Tweaks
• Fast Navigation

Feature Guides

Deep dives on every KeyPath feature — layer packs, app launching, window tiling, chords, and more.

• Numpad Layer
• Symbol Layer
• Function Layer
• Windows & App Shortcuts
• Quick Launcher
• Launching Apps
• Chords
• Memorable Shortcut Paths
• Auto-Shift Symbols
• Alternative Layouts
• Works With Your Keyboard
• KindaVim
• Neovim in the Terminal

Reference

Technical references, privacy details, and troubleshooting.

• Action URI Reference
• Privacy & Permissions

Switching Tools

Coming from Karabiner-Elements, Kanata, or another remapper? We've got migration guides for you.

• From Karabiner-Elements
• From Kanata

---

Developer Documentation

Contributing to KeyPath or building integrations? These interactive architecture guides cover the internals.

Architecture Guides

Interactive visual walkthroughs of KeyPath's internal systems, data flows, and design decisions.

• Installation Wizard
• Live Keyboard Overlay
• Runtime & Service Lifecycle
• PermissionOracle
• Rule Collections & Config
• Privileged Helper & XPC
• Keyboard Layouts
• KindaVim Integration