How do I install the Wispr skill?

Run npx skillmds@latest add vesely/wispr in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Wispr safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wispr?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Wispr free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

vesely (@vesely) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wispr by vesely — Agent Skill

Name: Wispr
Author: vesely

Wispr

Control the Wispr Flow voice dictation app on macOS from the shell via its `wispr-flow://` URL scheme — lets an AI agent (e.g. Claude Code) turn Wispr Flow listening on and off for the user. Use when the user wants an agent to start or stop dictation programmatically, toggle hands-free listening, or switch the dictation microphone — e.g. "start dictation", "start wispr", "start listening", "turn on wispr", "stop listening", "stop dictation", "switch mic".

vesely 26ab1b3 2.5 KB Updated Sep 17, 2026

File contents

wispr

Control Wispr Flow (the AI voice dictation app) from the command line on macOS via its registered wispr-flow:// URL scheme. No keystroke simulation, no Accessibility permission, no API key — just open.

The main use case: let an AI coding agent (Claude Code, or any tool that can run a shell command) turn Wispr Flow listening on and off for the user — e.g. the user says "start dictation" and the agent fires the start deeplink so they can speak their next prompt hands-free.

Requires the Wispr Flow desktop app installed and running, with Microphone permission granted.

Start listening (hands-free / toggle mode)

open "wispr-flow://start-hands-free"

Starts hands-free dictation — Flow keeps listening until stopped (unlike push-to-talk, which you hold). Dictated text is typed into whatever window currently has keyboard focus, so put the cursor where you want the text before triggering.

Stop listening

open "wispr-flow://stop-hands-free"

Switch microphone

open "wispr-flow://switch-mic?mic_name=<PREFIX>"

Switches to the first input device whose name starts with <PREFIX> (case-insensitive). Example:

open "wispr-flow://switch-mic?mic_name=MacBook"

Behavior / gotchas

start-hands-free only starts when Flow is idle. If dictation is already active it is silently ignored. To guarantee a clean start, send stop-hands-free first.
stop-hands-free only acts while in hands-free (locked) listening mode. It will not cancel a push-to-talk session.
Text lands in the focused field. Triggered from a terminal, Flow types into the terminal — switch focus to the target app first.
Undocumented / unofficial. These deeplink actions are not in Wispr Flow's public docs; they were verified against app version 1.5.980 (Apple Silicon, macOS) and may change in future releases. The documented, supported activation path is the in-app hotkey (default Fn for push-to-talk, Fn+Space for hands-free), configurable under Settings → General → Shortcuts.

---name: wisprdescription: Control the Wispr Flow voice dictation app on macOS from the shell via its `wispr-flow://` URL scheme — lets an AI agent (e.g. Claude Code) turn Wispr Flow listening on and off for the user. Use when the user wants an agent to start or stop dictation programmatically, toggle hands-free listening, or switch the dictation microphone — e.g. "start dictation", "start wispr", "start listening", "turn on wispr", "stop listening", "stop dictation", "switch mic".---# wisprControl [Wispr Flow](https://wisprflow.ai/) (the AI voice dictation app) from the command line on macOS via its registered `wispr-flow://` URL scheme. No keystroke simulation, no Accessibility permission, no API key — just `open`.The main use case: let an AI coding agent (Claude Code, or any tool that can run a shell command) **turn Wispr Flow listening on and off for the user** — e.g. the user says "start dictation" and the agent fires the start deeplink so they can speak their next prompt hands-free.Requires the Wispr Flow desktop app installed and running, with Microphone permission granted.## Start listening (hands-free / toggle mode)```bashopen "wispr-flow://start-hands-free"```Starts hands-free dictation — Flow keeps listening until stopped (unlike push-to-talk, which you hold). Dictated text is typed into **whatever window currently has keyboard focus**, so put the cursor where you want the text before triggering.## Stop listening```bashopen "wispr-flow://stop-hands-free"```## Switch microphone```bashopen "wispr-flow://switch-mic?mic_name=<PREFIX>"```Switches to the first input device whose name starts with `<PREFIX>` (case-insensitive). Example:```bashopen "wispr-flow://switch-mic?mic_name=MacBook"```## Behavior / gotchas- **`start-hands-free` only starts when Flow is idle.** If dictation is already active it is silently ignored. To guarantee a clean start, send `stop-hands-free` first.- **`stop-hands-free` only acts while in hands-free (locked) listening mode.** It will not cancel a push-to-talk session.- **Text lands in the focused field.** Triggered from a terminal, Flow types into the terminal — switch focus to the target app first.- **Undocumented / unofficial.** These deeplink actions are not in Wispr Flow's public docs; they were verified against app version **1.5.980** (Apple Silicon, macOS) and may change in future releases. The documented, supported activation path is the in-app hotkey (default **Fn** for push-to-talk, **Fn+Space** for hands-free), configurable under Settings → General → Shortcuts.

Frequently asked questions