$ show openclaw/Swabble
Swabble is a macOS 26 CLI daemon and Swift library that listens to the microphone, detects a configurable wake word (default 'clawd'), transcribes speech locally using Apple's Speech.framework (SpeechAnalyzer + SpeechTranscriber), and executes a user-defined shell hook with the transcript. It also supports offline file transcription to TXT or SRT. The architecture is a monolith Swift package with a library target (SwabbleCore) exposing reusable components like the speech pipeline, hook runner, config loader, and transcript store, and an executable target (SwabbleCLI) using the Commander library for command routing. Key data flows: microphone audio → AVAudioEngine tap → BufferConverter → SpeechAnalyzer → SpeechTranscriber → async stream → wake-word matching → HookRunner → shell process. External dependencies are limited to Apple frameworks and the Commander package. The codebase demonstrates strong use of Swift 6.2 concurrency (actors, async streams), careful process management with timeout and cancellation, and clean separation of concerns. It is well-tested with CI covering formatting, linting, unit tests, and release verification.
The LLM identified 3 files worth highlighting for reuse:
An extension on AttributedString that splits text into sentences using NLTokenizer, with optional max-length splitting at word boundaries. It preserves audio time range attributes from Speech framework results, making it suitable for generating SRT subtitles. This component is isolated (depends only on Foundation, CoreMedia, NaturalLanguage) and can be reused in any project needing sentence-level segmentation of attributed strings with time metadata.
An actor that runs a shell command with configurable cooldown, minimum character length, timeout, and environment injection. It handles process termination gracefully: sends SIGTERM on timeout, waits up to 100ms, then SIGKILL if still running. It also respects task cancellation during cleanup, killing surviving processes and throwing CancellationError. Reserved environment variables (SWABBLE_TEXT, SWABBLE_PREFIX) cannot be overridden by user config. This component is well-isolated (depends only on Darwin, Foundation, and a simple config struct) and can be extracted for any application needing a robust, cancellable shell command runner.
An actor that maintains an in-memory ring buffer of recent transcripts and persists them as newline-delimited JSON (JSONL) to a file. It enforces a configurable entry limit, writes atomically, and sets owner-only file permissions (0o600). On initialization, it reloads existing entries from the file, migrating pre-release plain-text lines. This component is self-contained (depends only on Foundation) and can be reused in any application needing a simple, thread-safe, persistent log with a bounded size.