explaingit

ericclemmons/aside

Analysis updated 2026-08-10 · repo last pushed 2026-04-13

8SwiftAudience · developerComplexity · 3/5MaintainedSetup · moderate

TLDR

Aside is a macOS menu bar app that lets developers control AI coding assistants with their voice, sending spoken prompts plus context from the current window to a command-line coding tool.

Mindmap

mindmap
  root((repo))
    What it does
      Voice to coding assistant
      Menu bar app
      On-device transcription
      Grabs window context
    How it works
      Press Right Option key
      Hold to type mode
      Tap to dispatch mode
      Sends to OpenCode
    Context capture
      Active app name
      Browser URL
      Selected text
    Speech engines
      Apple Speech
      WhisperKit
      Parakeet
    Tech stack
      Swift
      Native macOS UI
      macOS 14 Sonoma
    Audience
      Voice-driven developers
      Flow state coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Speak coding instructions hands-free while reading docs in your browser without switching windows.

USE CASE 2

Voice-control an AI coding assistant to build or fix code while staying focused on your editor.

USE CASE 3

Dictate text directly into any active field using hold-to-type mode.

USE CASE 4

Send spoken prompts with selected text context to a coding session via tap-to-dispatch mode.

What is it built with?

SwiftmacOS native UIWhisperKitParakeetApple SpeechOpenCode

How does it compare?

ericclemmons/aside98przem/mistgistya/ox0badf00d
Stars888
LanguageSwiftSwiftSwift
Last pushed2026-04-13
MaintenanceMaintained
Setup difficultymoderateeasymoderate
Complexity3/53/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS 14 Sonoma or later and needs microphone, speech recognition, and accessibility permissions granted to function.

In plain English

Aside is a macOS menu bar app that lets you control coding with your voice. Press a hotkey, speak your prompt, and it sends your words, along with context from whatever you're looking at, to an AI coding assistant. Instead of typing out instructions or switching windows, you just talk and your code editor gets the message. The app lives in your menu bar (no dock icon). You press the Right Option key from anywhere on your Mac and start speaking. It transcribes your speech on-device, meaning the audio is processed locally rather than sent to a cloud server. While you talk, it grabs context from your current window: which app is active, what URL your browser is on, and what text you have selected. Then it sends the whole package, your transcribed prompt plus that context, to OpenCode, a command-line coding assistant. It has two modes. "Hold to type" means you hold down the hotkey, speak, and release to type your transcribed words directly into whatever field is active. "Tap to dispatch" lets you tap to start recording, tap again to stop, pick a coding session with arrow keys, and send the prompt to OpenCode. The transcription can use Apple's built-in speech recognition, WhisperKit, or Parakeet, all running on your Mac. This is for developers who want to stay in flow and use voice instead of typing. If you're looking at code, reading documentation in a browser, or referencing a URL and want to ask an AI to build or fix something, you just speak naturally rather than breaking focus to type everything out. The project is written in Swift using native macOS UI tools, and requires macOS 14 (Sonoma) or later. It needs permissions for microphone, speech recognition, and accessibility access to work properly. The release process is fully automated, pushing code changes triggers automatic version bumps, builds, Apple notarization, and Homebrew updates.

Copy-paste prompts

Prompt 1
I want to build a macOS menu bar app in Swift that captures speech locally and sends transcribed text to a CLI tool. Aside does this with on-device transcription and context capture. How should I structure the app to grab the active window, browser URL, and selected text to pass along with the transcribed prompt?
Prompt 2
Help me implement hold-to-type and tap-to-dispatch voice modes in a Swift macOS app. Hold-to-type should hold a key, transcribe speech on-device, and type the result into the active field. Tap-to-dispatch should toggle recording, let the user pick a session with arrow keys, and send the prompt to a CLI coding assistant.
Prompt 3
I need to set up on-device speech recognition in a macOS menu bar app using Swift. Aside supports Apple Speech, WhisperKit, and Parakeet. How do I request microphone, speech recognition, and accessibility permissions, and which engine is easiest to start with for local transcription?
Prompt 4
How do I distribute a Swift macOS menu bar app with automated version bumps, Apple notarization, and Homebrew updates on every git push? Aside automates this entire release pipeline. Walk me through setting up GitHub Actions for notarization and Homebrew formula updates.

Frequently asked questions

What is aside?

Aside is a macOS menu bar app that lets developers control AI coding assistants with their voice, sending spoken prompts plus context from the current window to a command-line coding tool.

What language is aside written in?

Mainly Swift. The stack also includes Swift, macOS native UI, WhisperKit.

Is aside actively maintained?

Maintained — commit in last 6 months (last push 2026-04-13).

How hard is aside to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is aside for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.