Mac fleet · diagnose + repair
Wispr Doctor
A one-click tool that fixes the most common Wispr Flow issues on TWC Macs. Runs locally from a single Terminal command, ships telemetry back to the IT dashboard.
Run the doctor
Takes ~30 seconds. Paste this into Terminal:
bash <(curl -fsSL https://wispr.newpiedpiper.net/wispr-doctor.sh)
Wait, what's Terminal? How do I find it?
Terminal is a built-in Mac app that lets you type commands instead of clicking buttons. It comes with every Mac, you don't install anything.
How to open it:
- Press
⌘(Command) +Space, this opens Spotlight, Apple's search box. - Type
Terminal. - Press
Return. A dark window opens. That's Terminal.
What to do once it's open:
- Copy the gray
bash <(curl ...)command above (click anywhere inside the box and use⌘C). - Click the Terminal window so it's the active app, then paste with
⌘V. - Press
Return. The wizard takes it from there, you'll see text scroll, then it'll ask you yes/no questions.
You can't break anything by pasting the wrong thing, the worst case is Terminal says "command not found" and waits for the next one.
What happens after you paste it:
- Silent check.
Inspects 4 areas: hardware floor, Wispr helper processes, macOS permissions (Mic / Accessibility / Input Monitoring / Screen Recording), and network reachability to
api.wisprflow.ai. - Walk through each issue.
Each problem is shown as a card with What I noticed, What I'd do about it, and What that means for you, then a
Fix this? [Y/n]prompt. You stay in control. - Optional watcher.
If you want, the doctor installs a per-user LaunchAgent that checks Wispr every 60 s, pops a native macOS dialog when something looks off, and never auto-fixes silently. It also quietly reports memory and health back to the IT dashboard on its own, every couple of days and whenever your Mac is under real memory pressure, so problems show up even if you never run the doctor by hand. No personal content, just machine vitals.
Landing page
wispr.newpiedpiper.net hosts the friendlier launch page (same one-liner, with screenshots).
For IT
Telemetry rollup lives at the IT dashboard, fleet health, last-seen timestamps, fix counts, per-Mac memory-free trend over the last dozen reports, and each machine's top memory hogs and total Chrome footprint (click any row to expand). Google SSO; ping the Automation team if you can't get in.
The Samples column is cumulative: every telemetry check-in a Mac has sent in the window, the doctor runs someone starts by hand plus the watcher's automated heartbeats. That's why a Mac can show a handful of hands-on runs but dozens of samples, and why the number lines up with the report history when you expand the row.
Architecture
How the diagnostic wizard, the optional watchdog, and the telemetry backend fit together.