Keyboard Scanner
Claude Code plugin for profiling Linux keyboards, mapping keycodes, and identifying underused keys that can be repurposed for shortcuts and macros.
Install
/plugin marketplace add danielrosehill/Claude-Code-Plugins
/plugin install keyboard-scanner@danielrosehill
What it does
Walks a structured workflow:
- Intake — questionnaire to profile each keyboard (laptop vs desktop, make/model, layout, switch type, existing customizations, use case).
- Keycode scan — dumps the system's full keycode-to-keysym mapping using
xmodmap, setxkbmap, evdev definitions, xinput, libinput, etc. Detects X11 vs Wayland.
- Remap suggestions — analyses the profile and scan, then proposes remappings tailored to use case (programmer / writer / general). Points at concrete tools —
keyd, kmonad, xremap, xmodmap, xbindkeys, input-remapper, autokey.
Multiple keyboards are supported (laptop built-in + external mechanical, etc.) — run /intake once per keyboard.
Slash commands
| Command | Purpose |
|---|
/intake | Interactive questionnaire to profile a keyboard |
/scan-keycodes | Scan and document all keycodes on the system |
/suggest-remaps | Generate remap / shortcut / macro suggestions |
/list-profiles | Show all profiled keyboards and their scan status |
Agents
- keyboard-profiler — specialised subagent for deep keyboard analysis and keycode mapping.
Data storage
Profiles, scans, and suggestions are written under the user-data directory:
$CLAUDE_USER_DATA/keyboard-scanner/ if set- else
$XDG_DATA_HOME/claude-plugins/keyboard-scanner/
- else
~/.local/share/claude-plugins/keyboard-scanner/
Subdirs: keyboards/, keycodes/, profiles/, keymaps/, suggestions/.
Requirements
- Linux (X11 or Wayland)
- Claude Code CLI
- Standard input tools available:
xmodmap, setxkbmap, xinput, evtest, libinput, lsusb
License
MIT
f
rohitg00
anthropics
markus41
