
Swabble
github.com/openclaw/swabble- Category
- Developer Tools
- Rank
- No. 1476Tools index
Previous survey · No. 1483 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- openclaw
- GitHub
- 31 stars
- Date
About
Swift version of brabble.dev — OpenClaw's Swift port of the brabble protocol for native iOS/macOS integration.
What it does
Swabble turns spoken requests into local shell automation on a Mac. It monitors microphone input, waits for a configurable wake phrase, removes that phrase from Apple’s on-device transcription, then passes the remaining text to a chosen command. It also transcribes audio files into text or subtitles.
Why it's ranked here
The design is narrow and practical: local speech recognition feeds ordinary shell commands without a hosted service or bundled speech model. Configurable cooldown, minimum length, and timeout controls reduce accidental hook traffic. Its value is constrained by strict platform requirements and several unfinished service controls.
What's good
Audio remains on the Mac during transcription, apart from macOS obtaining Apple speech assets when needed. Hooks receive both a rendered text argument and protected environment values. Recent transcripts can persist locally for debugging. The same speech pipeline, configuration loader, hook runner, and transcript store are available to Swift applications.
Tradeoffs
It requires macOS 26 and Swift 6.2, so older Macs and other platforms are excluded. Wake detection is only text matching, not a dedicated detector. Preferred microphone settings are saved but ignored during live capture. Background service installation and start, stop, and restart controls remain stubs or placeholders.
How to use it well
Use Swabble for Mac-only voice shortcuts where a shell command is already the useful integration boundary. Keep hooks idempotent because recognizer output can be partial, retried, or corrected. Test commands before leaving the microphone loop running. Choose another tool if you need cross-platform capture, advanced wake detection, or finished service management.
Technical notes+
Package.swift declares Swift tools 6.2, macOS 26, a Swabble library product, a swabble executable, Commander from version 0.2.2, and a swabbleTests test target. Sources/swabble/main.swift resolves Commander descriptors, dispatches the documented command tree, reports errors to stderr, and returns process exit codes. Sources/swabble/CLI/CLIHelp.swift renders usage, subcommands, visible options, flags, and help text from command descriptors. README.md documents an AVAudioEngine to BufferConverter to AnalyzerInput to SpeechAnalyzer pipeline using SpeechTranscriber. docs/hooks.md specifies cooldown, minimum-length, timeout, environment injection, and nonzero-exit handling. docs/development.md says CI formats, lints, tests, release-builds, and smoke-checks the CLI on macos-26 with Xcode 26.
Observed
- Primary language
- Swift 6.2
- Platform support
- macOS 26 only
- Packaging
- Swift Package Manager package with library and executable products
- Interfaces
- Command-line application and embeddable Swift library
- Speech processing
- Apple Speech.framework on-device transcription; macOS may download speech assets
- Installation surface
- Builds from source with Swift Package Manager
- Testing structure
- Package manifest declares a swabbleTests test target
- External package dependency
- Commander, declared from version 0.2.2
Read from README.md, docs/cli.md, docs/spec.md, docs/index.md, docs/hooks.md, docs/install.md, docs/library.md, docs/quickstart.md, docs/development.md, docs/configuration.md, Package.swift, scripts/build-docs-site.mjs, scripts/docs-site-assets.mjs, Sources/swabble/main.swift, Sources/swabble/CLI/CLIHelp.swift.
What it can do
Enable native iOS app integration with brabble protocol
iOS application code → Brabble protocol connectivity
Enable native macOS app integration with brabble protocol
macOS application code → Brabble protocol connectivity
Provide Swift-native brabble protocol implementation
Swift project → Integrated brabble protocol support
Port brabble protocol functionality to Apple platforms
Existing brabble protocol calls → Native Swift equivalents
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.