a11y-vo-log: VoiceOver speech-logging plugin#7
Merged
Conversation
Capture a timestamped transcript of everything VoiceOver speaks (and each keyboard nav gesture, via Karabiner) during a manual screen-reader session on macOS, then diagnose it into an accessibility bug report via /a11y-log. One-time machine setup (VoiceOver AppleScript control, Automation permission, Karabiner gesture rules) lives in the plugin README, not in the skill body, so it never loads into context on invocation. The skill body is orchestration plus the announcement-diagnosis table. The Karabiner rules ship with a placeholder path stamped to a stable copy of vo_gesture.sh during setup, so plugin version bumps (versioned install path) don't break gesture logging.
Rename the plugin and both skills a11y-log -> a11y-vo-log (dirs, manifest, marketplace entry, and root README) so the name says VoiceOver up front. Note in the Karabiner section that Claude can run the (shell-only) setup for you if you trust it; drop the Data-handling note and Related plugins sections.
vo_log.sh now launches VoiceOver itself when it's off (open -a VoiceOver, wait for the process), instead of erroring out with 'turn it on first'. The poller's per-query pgrep guard is unchanged, so turning VO off at the end still keeps it off. VO_NO_AUTOSTART=1 restores the manual flow. start_log_terminal.sh: when Terminal.app isn't running yet, launching it already opens one window, so run the logger 'in window 1' instead of letting do script open a second window.
Contributor
Author
New plugins ship a CHANGELOG per the lean-contribute conventions.
a11y-audit isn't part of this repo, so remove the companion-skill mentions from the workflow skill, usage skill, README, and CHANGELOG.
wzslr321
reviewed
Jul 13, 2026
- Rename plugin and skills a11y-vo-log -> lean-a11y-vo-log (reviewer asked to align with the marketplace naming scheme; used the general lean- prefix since VoiceOver logging isn't a Flutter vertical). Trigger is now /lean-a11y-vo-log. - Trim the header/inline comments across vo_log.sh, start_log_terminal.sh and vo_gesture.sh to the non-obvious 'why' only. - Usage skill: list Karabiner-Elements as an explicit dependency for GESTURE lines. - README: clarify the Automation grant targets whatever app hosts Claude (the logger window is always Terminal.app).
wzslr321
added a commit
that referenced
this pull request
Jul 13, 2026
Revert "a11y-vo-log: VoiceOver speech-logging plugin" (#7)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
tldr: skill to put VoiceOver sound cues + pressed VO navigation combinations to terminal (self installed keylogger lmao).
Useful to report real a11y issues for AI to fix (easier than describing it naturally/via video. Also AI is terrible when it comes to predicting VO behavior).
🤖
edited_output.mp4
🤖 Generated with Claude Code