Brabble

🎙️ Brabble — Open hailing frequencies… and run the command.

Always-on, local-only voice daemon for macOS. Hears your wake word (“clawd” by default), transcribes with whisper.cpp, then fires a configurable hook (user-defined, e.g., warelay heartbeat). Written in Go; ships with a daemon lifecycle, status socket, and launchd helper.

Quick start

• Requirements: Go 1.25+, brew install portaudio pkg-config, a whisper.cpp model.
• One-liner: pnpm brabble setup && pnpm start (downloads medium Q5_1, writes config, starts daemon).
• Foreground run: go run ./cmd/brabble serve (mic + PortAudio required).

CLI surface

• start | stop | restart — daemon lifecycle (PID + UNIX socket).
• status [--json] — uptime + last transcripts; tail-log shows recent logs.
• mic list|set [--index N] — enumerate or select microphone (aliases: mics, microphone).
• models list|download|set — manage whisper.cpp models under ~/Library/Application Support/brabble/models.
• setup — download default model and update config; doctor — check deps/model/hook/portaudio.
• test-hook "text" — invoke hook manually; health — ping daemon; service install|uninstall|status — launchd helper (prints kickstart/bootout commands).
• transcribe — run whisper on a WAV file; add --hook to send it through your configured hook (respects wake/min_chars unless --no-wake).
• Hidden internal: serve runs the foreground daemon (used by start/launchd).
• --metrics-addr enables Prometheus text endpoint; --no-wake bypasses wake word.

PNPM helpers (all build Go, no JS runtime)

• pnpm brabble — build then start daemon (default); extra args pass through, e.g. pnpm brabble --help, pnpm brabble status.
• pnpm start|stop|restart — lifecycle wrappers.
• pnpm build — build to bin/brabble; pnpm lint — golangci-lint run; pnpm format — gofmt -w .; pnpm test — go test ./....
• Lint deps: brew install golangci-lint; CI runs gofmt+golangci-lint+tests (see `