Skip to content

Decision 001: all five shortcuts are everyday #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dabodamjan merged 1 commit into from
Oct 22, 2026
Merged

Decision 001: all five shortcuts are everyday #3

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/decisions/001-shortcuts-live-in-karabiner.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Two facts, both checked against the current docs:

The binding lives one layer down, at the HID level, as a Karabiner-Elements complex modification: Right Option plus a key types the command text, waits, presses Escape, then Enter. The receiving application only sees keystrokes, so the same rule reaches the desktop app, any terminal and VS Code. I have verified the Escape-then-Enter sequence on the desktop app; the other two surfaces receive the same keys but I have not tested them.

Right Option specifically, so that left Option stays free for special characters and for Claude Code's own Option+O / Option+P / Option+T bindings. The `, . /` cluster sits under the right hand's resting position, which keeps the three frequent shortcuts one-handed. The two rare ones (`'` and `\`) sit further out on purpose: a shortcut that must never fire by accident should cost a reach.
Right Option specifically, so that left Option stays free for special characters and for Claude Code's own Option+O / Option+P / Option+T bindings. All five sit under the right hand around Right Option, so every shortcut is one-handed. The `, . /` cluster sits closest to the resting position; `'` and `\` are the two furthest keys and run the two closing commands, `/end-session` and `/archive-session`.

## What the shortcut types

Expand Down
Loading