Skip to content

[Bug]: OpenSuperWhisper shown in workflow video is missing from reproducible setup #23

Description

@aleks-tomoro

What happened?

The agentic engineering workflow video shows OpenSuperWhisper as part of the day-to-day setup, but it is absent from this repository's Homebrew casks and Home Manager configuration:

The video shows a particularly useful low-latency setup:

  • key-combination trigger: Option + backtick (`⌥``)
  • Hold to Record enabled
  • Whisper engine with a locally downloaded model
  • English transcription
  • Suppress Blank Audio enabled
  • Add Space After Sentence enabled
  • a custom initial prompt containing frequently used technical/project vocabulary

However, configuration.nix declares only wezterm and claude-code as casks. There is no OpenSuperWhisper configuration or documentation elsewhere in the repo. Because Homebrew activation uses cleanup = "zap", installing the app manually also appears inconsistent with the repository's declarative workflow and may cause it to be removed by a later rebuild.

What did you expect to happen?

Since the repository and walkthrough present a reproducible fresh-Mac setup, I expected OpenSuperWhisper to be included as the opensuperwhisper Homebrew cask and its important settings to be reproducible or documented.

In particular, documenting the Option + backtick hold-to-record shortcut would be valuable. It launches much faster than macOS's built-in microphone-key dictation flow and is easy to miss from the video alone.

If OpenSuperWhisper's preferences cannot reasonably be managed declaratively, a short README section covering the manual settings and selected model would close the gap.

Reproduction steps

  1. Clone the repository.
  2. Inspect the homebrew.casks list in configuration.nix or apply the configuration on a fresh Apple Silicon Mac.
  3. Observe that OpenSuperWhisper is not installed.
  4. Search the repository for opensuperwhisper, OpenSuperWhisper, or its shortcut/settings and observe that they are not documented.

Environment

  • macOS

Nix or home-manager generation

Not generation-specific; current main configuration.

Relevant logs or output

homebrew = {
  onActivation.cleanup = "zap";
  casks = [
    "wezterm"
    "claude-code"
  ];
};

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions