Skip to content

feat(macos): keyboard shortcut scheme for launcher/clipboard/voice#183

Open
paveg wants to merge 1 commit into
mainfrom
feat/macos-keyboard-shortcuts
Open

feat(macos): keyboard shortcut scheme for launcher/clipboard/voice#183
paveg wants to merge 1 commit into
mainfrom
feat/macos-keyboard-shortcuts

Conversation

@paveg

@paveg paveg commented Jul 7, 2026

Copy link
Copy Markdown
Owner

Why

superwhisper, Raycast (launcher + Clipboard History), and 1Password were colliding on global hotkeys — most painfully both defaulting to ⌥Space. This assigns one modifier "address" per functional layer so nothing fights over the same key.

Scheme

Role Key Owner How set
Launcher ⌘Space Raycast Scripted (raycastGlobalHotkey = Command-49)
Clipboard History ⌃Space Raycast extension Manual (Raycast UI)
Dictation (hold) ⌥Space superwhisper App default
Password Quick Access ⇧⌘Space 1Password App default
Autofill ⌘\ 1Password App default

What the script does

.chezmoiscripts/run_onchange_after_configure-macos-keyboard.sh (darwin only):

  • AppleFnUsageType = 0 — fn/globe alone does nothing (IME is Karabiner's job via single-cmd → 英数/かな).
  • Disables symbolic hotkeys 60/61 (input-source switch) and 64/65 (Spotlight), freeing ⌃Space and ⌘Space.
  • Sets the Raycast launcher to ⌘Space.

Notes

  • HHKB-aware: no shortcut uses fn, because the HHKB Fn key is a firmware-layer key that never reaches macOS. Documented in docs/macos-keyboard-shortcuts.md.
  • Manual steps that can't be scripted (Clipboard History → ⌃Space in the Raycast UI) are listed in the doc's new-machine checklist.
  • Verified on this machine: raycastGlobalHotkey = Command-49 persists across restart; superwhisper inserts on ⌥Space.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FZ7jiThmqAoCdSVHsr1shU

Assign one modifier "address" per functional layer so Raycast, its
Clipboard History extension, superwhisper, and 1Password stop colliding
on ⌥Space. A darwin-only chezmoi script disables the redundant macOS
input-source and Spotlight hotkeys (Karabiner already handles IME via
single-cmd) and moves the Raycast launcher to ⌘Space; docs record the
full scheme plus the manual steps that can't be scripted.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FZ7jiThmqAoCdSVHsr1shU
@changeset-bot

changeset-bot Bot commented Jul 7, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: bd254a0

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

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.

1 participant