Superwhisper Claude Code Plugin
A plugin linking Superwhisper and Claude Code: when the agent finishes or waits, a window opens for a voice reply.
- 63 ★ on the repository
- Last commit
Extended access
Why this level
- Install changes Claude Code settings and adds hooks.
- The install script runs through `curl | bash`.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/superwhisper-claude-code-pluginDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Install changes Claude Code settings and adds hooks.
- The install script runs through `curl | bash`.
This is third-party code. Review the repository files before installing.
What it does
The plugin adds voice replies to Claude Code work. When the agent finishes a task or needs your decision, Superwhisper opens over other windows and you respond by voice, typing or choosing an option. An agent stop calls the `stop.sh` hook, registered by a setting in `~/.claude/settings.json`. It includes a Superwhisper toggle skill, a status line script and plugin and marketplace manifests. Superwhisper version 2.13 or newer on macOS is required. Plugin health is checked with `/hooks` inside Claude Code, which lists registered hooks.
Who it is for. macOS users with Superwhisper who run Claude Code by voice and do not want to watch the terminal.
Good fit when
- A long task runs in the background and the agent reply is wanted by voice.
- The agent asks permission and answering with words is easier.
- You want to see the Claude Code status in the status line.
- Voice mode must be switched on and off by a separate skill.
Not a fit when
- You work on Windows or Linux: the plugin is macOS only.
- Superwhisper is older than version 2.13.
- Voice input is not needed.
Example request
Check via /hooks that the Superwhisper hook is registered, then run the task and report when done so I can reply by voice.Limitations
It works only on macOS with Superwhisper 2.13 or newer. The main install runs a script through `curl -fsSL ... | bash` and adds hooks to `~/.claude/settings.json`; if you prefer, choose the manual path via `claude plugin marketplace add`. No licence is stated in the repository. Claude Code must be restarted after install. The hook fires when the agent stops, so the Superwhisper window will open over other applications.
How to disable. Remove the plugin with `claude plugin uninstall superwhisper` and delete the Superwhisper entries from `~/.claude/settings.json`, then restart Claude Code.
FAQ
How do I check the plugin is loaded?
Run `/hooks` in Claude Code: the Superwhisper hooks should be listed. The configuration is also visible in `~/.claude/settings.json`.
Which Superwhisper version is needed?
2.13 or newer, macOS only.
Can I skip the install script?
Yes, through `claude plugin marketplace add` and `claude plugin install`, or by running Claude Code with the `--plugin-dir` flag.
What opens the Superwhisper window?
An agent stop: the `stop.sh` hook is called when a task finishes or when the agent waits.
Does the plugin listen to the microphone constantly?
The README does not say: the microphone is controlled by the Superwhisper app itself.
Discussion
No questions or reviews yet.
Related
PluginsA Warp plugin for Claude Code that sends native notifications when a task ends, a permission is requested or Claude waits for you
echook plays a sound, a desktop toast or a message when Claude Code, Cursor or Codex finishes or waits for your permission
Two plugins change how Claude Code output looks: replies in the glamour dark style and tool calls as compact one-liners.
A Claude Code plugin that catches your corrections in chat and, after review, writes them into CLAUDE.md and AGENTS.md
hush quiets running narration in Claude Code and puts the result first: what changed and what comes next.
Hook-driven sounds for coding agents: starts, failures, completions and even individual Bash commands each get their own cue
README in short
A hook on agent stop opens Superwhisper so you can reply by voice. It works on macOS with Superwhisper 2.13 or newer.