Native ScreenCaptureKit engine. Lossless system audio + microphone capture. Local Whisper transcription. Realtime live assist HUD. Zero cloud leaks.
~ $ localscribe start --name "Q4 Architecture Sync" --live --notes
building capture helper... done
recording -> 2026-10-21_14-30-00_q4-architecture-sync.mp4
stop with: localscribe stop
live assist: opened in foreground HUD [TUI active]
[14:30:05] sysaudio attached
[14:30:06] microphone channel 0 linked
[14:30:08] whisper live segmenter: ggml-base.en active
⚡ Status: Recording 2026-10-21_14-30-00_q4-architecture-sync (0m15s)
Native macOS ScreenCaptureKit capture. Record full displays, individual windows by title or app, or interactively drag-to-select regions on screen.
No BlackHole. No Soundflower. No kernel extensions. Localscribe taps the ScreenCaptureKit system audio stream directly and isolates mic audio on separate tracks.
Powered by local whisper.cpp. Automatically parses language or runs Bangla with large-v3-turbo, Hindi, Urdu, Spanish, Arabic, or English base.
A dual-speaker realtime terminal feed while recording. Distinguishes who spoke (me vs them). Ask Hermes questions in real time with ?question.
Hermes turns messy conversation transcripts into structured notes: Summary, Key Points, Decisions, and Action Items stamped with transcript clock [mm:ss].
Draw directly over the screen during presentations or reviews. Native transparent Metal-backed canvas spawns as a sidecar process.
| Command | Options | Description |
|---|---|---|
localscribe start |
--name, --out, --live, --notes, --transcribe, --draw, --lang |
Starts recording screen + system sound + mic. Opens live TUI or detaches with -d. |
localscribe stop |
(none) |
Stops the active recording session, runs stop hooks (Whisper transcription & Hermes notes). |
localscribe status |
--json |
Checks whether recording is active, returns file path, start timestamp, and elapsed time. |
localscribe live |
--role <role>, --context <file> |
Re-attaches the realtime interactive TUI HUD to a detached background recording. |
localscribe captions |
(none) |
Streams live speaker-attributed transcription text lines to standard output. |
localscribe notes <file> |
--lang <language>, --name <name> |
Regenerates structured AI meeting notes from an existing recording or transcript. |
localscribe devices |
--json |
Lists all connected displays, active macOS windows, and available microphones. |
localscribe list |
(none) |
Lists all finalized video recordings in ~/Movies/localscribe sorted newest first. |
┌────────────────────────────────────────────────────────────────────────┐
│ LOCALSCRIBE CLI │
│ (TypeScript + Bun Runtime / Process Runner) │
└────────────────────────────────────┬───────────────────────────────────┘
│
┌─────────────────────────┼─────────────────────────┐
▼ ▼ ▼
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
│ SCREEN CAPTURE │ │ AUDIO ROUTING │ │ WHISPER LIVE ENGINE│
│ Native Swift (SCK) │ │ System Audio (SCK) │ │ ffmpeg 16k mono wav│
│ Displays / Windows │ │ Mic Audio (ffmpeg) │ │ whisper.cpp worker │
└──────────┬──────────┘ └──────────┬──────────┘ └──────────┬──────────┘
│ │ │
└─────────────────────────┼─────────────────────────┘
▼
┌─────────────────────────────┐
│ RECORDING COMPLETE │
│ ffmpeg AAC + H.264 Muxer │
└──────────────┬──────────────┘
▼
┌─────────────────────────────┐
│ HERMES NOTES ENGINE │
│ Hardened temp sandbox │
│ Delimited untrusted block │
│ Summary + Actions [mm:ss] │
└─────────────────────────────┘