Install

Swabble requires macOS 26 and the Speech.framework assets available on the target Mac. Building from source also requires Swift 6.2 or newer.

#Download a release

GitHub Releases provides swabble-macos.zip, a Developer ID-signed and notarized universal binary for Apple Silicon and Intel Macs, plus SHA256SUMS and release-inventory.json.

curl -fLO https://github.com/openclaw/Swabble/releases/download/v0.1.1/swabble-macos.zip
curl -fLO https://github.com/openclaw/Swabble/releases/download/v0.1.1/SHA256SUMS
shasum -a 256 -c SHA256SUMS
ditto -x -k swabble-macos.zip .
./swabble --version
./swabble health
install -m 755 swabble /usr/local/bin/swabble

Installing to /usr/local/bin may require sudo. The first release is distributed through GitHub; there is no Homebrew formula yet. Speech recognition depends on the locales and assets supported by Apple's Speech framework on the target Mac.

#Clone

git clone https://github.com/openclaw/swabble.git
cd swabble

#Tooling

The development checks use SwiftFormat and SwiftLint:

brew install swiftformat swiftlint

#Build

swift build

#Create config

swift run swabble setup

This writes the default JSON config to ~/.config/swabble/config.json. It refuses to replace an existing config unless you explicitly pass --force.