Skip to content

fix(karabiner): reset tab-switcher state with modifiers held; refresh README - #75

Draft
AH-Merii wants to merge 1 commit into
mainfrom
fix/karabiner-tab-switcher
Draft

AH-Merii wants to merge 1 commit into
mainfrom
fix/karabiner-tab-switcher

Conversation

@AH-Merii

@AH-Merii AH-Merii commented Sep 7, 2026

Copy link
Copy Markdown
Owner

A Karabiner from with no modifiers block matches only when nothing else is held. The four manipulators that reset the tab-switcher state were written that way, so under Ctrl+Shift+Tab — Shift already down before Ctrl goes down — the reset never matched, ctrl_tab_active stayed set, and Ctrl+Left/Right word navigation stayed disabled until the next bare Ctrl tap. Same for Alt+Shift+Tab.

The README had drifted alongside it: three rules undocumented, Ctrl+Up/Down described as mapping to Option like the Left/Right pair does, and install steps that predate mise run link.

There is no Mac in this environment, so these manipulators are written off the Karabiner docs and never observed. Worth trying Ctrl+Shift+Tab and then Ctrl+Left in a browser once Karabiner reloads the file, which is the exact sequence that was failing.

Closes #62

… README (#62)

The four "Track Tab Switcher State" reset manipulators (left/right control and option) had no from.modifiers, so per the Karabiner docs they only matched when no other modifier was held. Ctrl+Shift+Tab (previous tab) therefore never fired to_after_key_up, ctrl_tab_active stayed 1, and Ctrl+Arrow word navigation stayed disabled until the next bare Ctrl tap. Add "optional": ["any"] so the reset matches with any modifier held; optional modifiers are preserved in the to events.

README: document the Ghostty Hyper+S/F and Cmd+. emoji rules, split Ctrl+Left/Right (Option) from Ctrl+Up/Down (Cmd), note that treat_as_built_in_keyboard is pinned to one device ID, and replace the cp/ln install steps with the repo mise run link / stow flow.

@AH-Merii AH-Merii left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fyi​

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

karabiner: tab-switcher state sticks when Shift is held; README drift

1 participant