Skip to main content

How-to

Dictation in GitHub Issues on a Mac

Dictate repro steps, expected vs actual, and acceptance criteria — then edit for precision.

Last updated: 2025-12-27

GitHub issues are mostly prose. Dictation is a cheat code here: talk through the repro and context, then edit the last 10% for clarity.

Option A: Use macOS Dictation in the browser

  1. Open GitHub in your browser and click into the issue title/body.
  2. Start macOS Dictation (shortcut often Fn twice).
  3. Speak your issue. Stop Dictation to insert.
  4. Edit: code blocks, file paths, and identifiers are still faster to type.

Option B: Use Voice Type (best if you file issues daily)

  1. Install Voice Type and set a hold‑to‑dictate hotkey.
  2. Hold hotkey to dictate the issue body; release to finalize.
  3. Use the same hotkey in VS Code, Cursor, Linear/Jira, and Slack.

A template you can dictate (high signal)

Dictate this structure, then edit:

  1. One sentence summary (what broke).
  2. Steps to reproduce (numbered).
  3. Expected vs actual result.
  4. Environment (OS, version, browser).
  5. Acceptance criteria (checklist).

Troubleshooting (mic permissions)

Keep going

Sources

Try Voice Type (7‑day free trial)