switch-joycon-vibe-coding-karabiner-rules

English | 简体中文

This project turns a Nintendo Switch Joy-Con into a lightweight controller for agent-assisted coding, replacing a small set of frequent desktop actions with mapped button shortcuts.

With Karabiner-Elements, the Joy-Con buttons are remapped to common keyboard shortcuts so it becomes easier to switch sessions, send instructions, and control tools like Claude Code and other coding agents without constantly reaching back to the keyboard.

What This Project Is For

It is mainly designed for an agent-assisted coding workflow:

• quickly switch between multiple Claude Code sessions
• pair with speech input tools to turn your ideas into agent-readable instructions faster
• move a small set of high-frequency actions onto the Joy-Con to reduce keyboard context switching

Included Shortcuts

The current mapping focuses on a few actions that come up often when working with coding agents:

• enter
• escape
• delete_or_backspace
• cmd+enter
• ctrl+c
• cmd+c
• cmd+v

Structure

• src/json/joycon.json: editable source file
• dist/joycon.json: distributable Karabiner import file
• scripts/install.sh: installs the rule into Karabiner's local complex modifications directory
• assets/screenshots/: screenshots for the GitHub README

Install

./scripts/install.sh

Then open:

Karabiner-Elements > Complex Modifications > Add rule

Look for the rule set titled Switch Joycon Vibe Coding Karabiner Rules, then enable Joycon.

Setup Screenshots

1. Run the install script

This copies the local rule file into Karabiner's complex_modifications directory.

2. Add and enable the imported rule

Open Karabiner-Elements > Complex Modifications > Add rule, then find Switch Joycon Vibe Coding Karabiner Rules and enable Joycon.

3. Confirm the rule is enabled

After enabling it, the Joycon rule appears in the active Complex Modifications list.

4. Review or edit the rule content

You can also inspect the imported JSON directly from Karabiner's edit view.

Current rule mappings

• button11 -> cmd+tab
• dpad_left -> cmd+ctrl+[
• dpad_right -> cmd+ctrl+]
• dpad_down -> cmd+shift+[
• dpad_up -> cmd+shift+]
• button5 -> cmd+c
• button6 -> cmd+v
• button9 -> delete_or_backspace
• button16 -> right_option
• button14 -> cmd+grave_accent_and_tilde
• button2 -> cmd+enter
• button1 -> ctrl+c
• button3 -> escape
• button4 -> enter
• button12 -> right_option+right_shift
• button15 -> right_option+spacebar

Notes

If you want to add more rules later, it is recommended to update src/json/joycon.json first, verify the changes there, and then sync them to dist/joycon.json. This keeps the repository easier to maintain and makes it simpler to expand with more controller mappings over time.