Skip to content

github

This directory provides voice-command integration for the GitHub web interface using Talon. It enables hands-free navigation and control of GitHub repository pages, issue trackers, pull requests, and workflows by mapping natural spoken commands to GitHub's native keyboard shortcuts.

GitHub Web Integration

The integration is driven by a single key file:

  • github_web.talon: Defines the context and voice commands for interacting with GitHub in a web browser.

How It Works

The commands defined in github_web.talon are context-aware. They activate only when you are using a web browser (tag: browser) and navigating to github.com (browser.host: github.com).

Once active, the file translates spoken commands into key combinations that trigger GitHub's built-in shortcuts. The commands are organized into several functional areas:

  • Global Navigation: Commands like "go to notifications" or "go to dashboard" execute multi-key sequences (e.g., typing g then n, or g then d) to jump between high-level pages.
  • Repository Tabs: Quick transitions between tabs inside a repository, such as "go to code" (g + c), "go to issues" (g + i), or "go to actions" (g + a).
  • Code Navigation & Editing: Supports opening the GitHub web editor with "[web] editor open" (which presses .), searching for files using "file find" (t), and looking up blames or toggling comments.
  • Issues and Pull Requests: Voice shortcuts simplify managing workflows. You can assign users ("assignee set"), apply labels ("label set"), set milestones ("milestone set"), submit comments ("comment submit"), or preview markdown ("comment preview").
  • Actions & CI/CD: Controls specifically designed for GitHub Actions, including "timestamps toggle" and "fullscreen toggle" to monitor workflow runs.