Skip to content

Clarify fn double-fire symptom in Globe Key Override messaging - #268

Merged
alexkroman merged 2 commits into
mainfrom
claude/charming-planck-qs2fxd
Oct 29, 2026
Merged

alexkroman merged 2 commits into
mainfrom
claude/charming-planck-qs2fxd

Conversation

@alexkroman

Copy link
Copy Markdown
Collaborator

What & why

Reframes the GlobeKeyOverride user-facing messaging to lead with the observable symptom (fn may also open emoji picker or Apple Dictation until next login) rather than the technical implementation detail (macOS setting name). This makes the message more actionable and less mysterious to users.

Updates documentation across four files to reflect this messaging change:

  • HotkeyStepView.swift: Rewrites the footer text shown when fn is selected as the dictation key, emphasizing the symptom and the workaround (opening Keyboard Settings now)
  • AGENTS.md: Updates the architecture notes to describe what users see rather than what the code does
  • GlobeKeyOverride.swift: Clarifies the comment about what the footer warns users about
  • Sources/BlurtEngine/README.md: Updates the technical documentation to match the new messaging approach

The change preserves all existing behavior—only the explanation to users is improved.

How it was tested

  • scripts/check.sh passes (or CI will, if I'm not on a Mac)
  • I read AGENTS.md and this doesn't reintroduce anything deliberately removed
  • Docs updated if behavior changed

https://claude.ai/code/session_01DS5B1Wg3XkPktTQPXzG7Xy

The Shortcut footer shown when fn is the dictation key named the macOS
setting GlobeKeyOverride changes ("Press 🌐 key to" → Do Nothing) and a
log-in timing caveat in one dense sentence, with "to stop 🌐 firing
sooner" assuming the reader already knew the globe key fires anything.

Lead with the symptom instead: until the next log-in, fn may also open
the emoji picker or Apple Dictation, and Keyboard Settings fixes that
now. Update the engine doc comment, README and AGENTS.md sentences that
describe what the footer says.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DS5B1Wg3XkPktTQPXzG7Xy
@alexkroman
alexkroman enabled auto-merge (squash) October 29, 2026 18:25
Keep the reworded fn footer over the multi-key condition and
sync(boundKeys:) signature from #264.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DS5B1Wg3XkPktTQPXzG7Xy
@alexkroman
alexkroman merged commit c81f9f1 into main Oct 29, 2026
12 checks passed
@alexkroman
alexkroman deleted the claude/charming-planck-qs2fxd branch October 29, 2026 18:51
@alexkroman alexkroman mentioned this pull request Oct 30, 2026
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.

2 participants