A command-line tool for macOS
OCR, detection, segmentation, transcription and speech — powered by Apple frameworks, entirely on device. No network. No cloud. Ever.
$ brew install wkoszek/tap/sense
Signed, notarized universal binary · macOS 15 or newer · MIT licensed
sense vision for pixels, sense audio for sound. Everything runs locally through Vision, CoreImage, AVFoundation, ScreenCaptureKit, Speech and friends — your files never leave the machine.
Network use is opt-in only, and only for one flag: transcribe --allow-network.
stdout is data, stderr is status. JSON everywhere, deterministic exit codes, stdin with -.
Developer ID signed and notarized by Apple, so permission grants survive every upgrade.
Live Text OCR, face and barcode detection, subject cutouts, smart crops, screen capture — the whole Vision framework, one flag away.
$ sense vision ocr scan.pdf --md > notes.md
$ sense vision screenshot | sense vision ocr -
$ sense vision detect group.jpg --what faces --json
$ sense vision detect poster.jpg --what barcodes
$ sense vision filter photo.jpg out.jpg --redact faces --redact-blur
$ sense vision segment photo.jpg --person --blur-bg 25 -o portrait.png
$ sense vision dedupe ~/Pictures/Export
$ sense vision video ocr recording.mov --changes --srt > captions.srt
Record, transcribe, speak, convert, trim, split — with voice-activity detection and on-device speech recognition. Before your first talk: install the premium voices. They're a free download and sound dramatically better.
Opens System Settings where the free premium voices are downloaded — a large quality jump for talk.
$ sense audio voices --install
Add --premium to see just the good ones.
$ sense audio voices
$ sense audio transcribe interview.m4a
$ sense audio transcribe talk.m4a --srt > talk.srt
$ sense audio record -o note.wav --vad 2
$ sense audio talk "The build finished successfully"
$ sense audio talk -f notes.md -o notes.mp3
$ sense audio gain in.wav out.wav --normalize --db -3
Every command reads stdin and writes clean stdout, so vision and audio chain together like any other Unix tool.
$ sense vision ocr contract.pdf --md | sense audio talk -m
$ sense audio record -d 5 | sense audio transcribe -
Homebrew pulls a signed, notarized universal binary for Apple silicon and Intel. Requires macOS 15 (Sequoia) or newer.
$ brew install wkoszek/tap/sense
Camera, microphone and screen recording are tied to the code signature, so a grant you give once keeps working across upgrades.
$ sense vision doctor --request
Every release is signed with the project's Developer ID and notarized by Apple.
$ codesign -dv --verbose=2 "$(brew --prefix)/bin/sense" 2>&1 | grep TeamIdentifier TeamIdentifier=QQ5A9Q7C7Z