La CLI de superwhisper: cómo instalarla, todos sus comandos y el servidor MCP
Por Ryleigh Newman · Publicado el
superwhisper tiene una herramienta de línea de comandos para Mac, que también se llama superwhisper. Busca y exporta tu historial local de dictados, edita el vocabulario y los reemplazos, y controla la app en ejecución: empezar, parar, cambiar de modo, transcribir un archivo. También puede funcionar como servidor MCP (Model Context Protocol), que deja a un asistente de IA buscar y leer tus dictados.
Hago YapToText, otra app de dictado para Mac, así que lee con eso en mente lo que digo de superwhisper. Cada dato sobre superwhisper de esta página sale de su propia documentación, leída el 10 de octubre de 2026. La página es CLI and MCP server.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
Esta guía en otros idiomas: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Instalarla
curl -fsSL https://superwhisper.com/install-cli.sh | bashQué pasa: El script instala la última versión en /usr/local/bin, o en ~/.local/bin si no se puede escribir en la primera.
Si después tu shell no encuentra superwhisper, añade ~/.local/bin a tu PATH. La documentación dice que los binarios y las sumas de verificación se publican en el repositorio superultrainc/superwhisper-cli-release de GitHub, así que puedes leer el script de instalación antes de ejecutarlo. La CLI es solo para macOS.
Comandos que leen tu historial
De la página de la documentación de superwhisper CLI and MCP server, leída el 10 de octubre de 2026. Leen la misma base de datos local que la app y se ejecutan en tu dispositivo.
| Comando | Qué hace |
|---|---|
| search | Búsqueda de texto completo en todas las transcripciones. Admite AND, OR, NOT, frases entre comillas y un asterisco de prefijo |
| history | Enumera las transcripciones recientes. Se filtra con --mode, --since y --before |
| read | Lee una transcripción, la última si no das ningún ID. --raw muestra el texto antes del procesamiento con IA |
| stats | Estadísticas de las transcripciones |
| modes | Enumera los modos usados en tus grabaciones, con recuentos |
| export | Lo exporta todo, de la más antigua a la más reciente, como jsonl o markdown |
| vocab | Enumera, añade o quita términos del vocabulario |
| snippets | Enumera, define o quita reemplazos, los mismos pares From y To que en Settings, Vocabulary |
| doctor | Información de diagnóstico sobre la base de datos, para informes de errores |
| completions | Genera las completaciones del shell |
Comandos que controlan la app
De la misma página. Envían una petición a la app en ejecución, así que superwhisper tiene que estar abierto.
| Comando | Qué hace |
|---|---|
| record | Activa o desactiva la grabación |
| start | Empieza a grabar. No hace nada si ya está grabando |
| stop | Para la grabación. No hace nada si no está grabando |
| switch | Cambia el modo activo por nombre o por clave. Sin argumento, enumera tus modos |
| settings | Abre la ventana de ajustes |
| transcribe | Envía un archivo de audio a la app para transcribirlo. La transcripción de archivos necesita Pro |
start, stop y switch hacen que superwhisper se pueda automatizar desde cualquier cosa que ejecute un comando de shell. Eso incluye un lanzador, un reasignador de teclas o un botón de una interfaz de conmutador de accesibilidad.
Ejemplos
superwhisper search "quarterly report"
superwhisper history --since 2026-09-01 --mode Mail
superwhisper read --raw
superwhisper export -f markdown > dictations.md
superwhisper vocab add "Superwhisper"
superwhisper switch Message
superwhisper transcribe ~/Downloads/note.m4aQué pasa: Cada línea es uno de los ejemplos de la propia documentación. La mayoría de los comandos también aceptan --json para dar una salida que un script pueda leer.
El servidor MCP
superwhisper mcpQué pasa: La CLI habla MCP por stdio y expone herramientas para buscar, ver el historial, leer grabaciones, modos, estadísticas, vocabulario y reemplazos.
Un punto de privacidad de la documentación: la CLI en sí se ejecuta por completo en tu dispositivo, pero cuando un asistente de IA está conectado por MCP, las transcripciones que consulta se envían a ese asistente y se tratan según los ajustes de su propio modelo y de sus datos. La página de privacidad de superwhisper cubre el resto.
YapToText y la línea de comandos
YapToText no tiene herramienta de línea de comandos ni servidor MCP. Es una app de la barra de menús con una sola tecla. Su página History exporta toda la lista como texto sin formato o Markdown, lo que cubre la exportación sin usar Terminal.
Para transcribir desde Terminal sin comprar nada, whisper.cpp es el motor sobre el que está construido YapToText. La guía de Whisper en local tiene los comandos, y la página de la CLI de MacWhisper trata de la herramienta de otra app para archivos y carpetas.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
La versión corta
- Instalar. Una línea con curl, solo macOS.
- Leer. search, history, read, stats y export.
- Controlar. record, start, stop, switch y transcribe, con la app abierta.
- MCP. superwhisper mcp, por stdio.
- Privacidad. Local, hasta que un asistente lea transcripciones por MCP.
Si superwhisper añade comandos o les cambia el nombre, abre un issue en GitHub y actualizaré esta página. Los leo todos.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
Guías
Más guías, en inglés
Fuentes
- https://superwhisper.com/docs/get-started/cli (consultado el 10 de octubre de 2026)
- https://superwhisper.com/docs/get-started/history (consultado el 10 de octubre de 2026)
- https://github.com/ryleighnewman/YapToText (consultado el 10 de octubre de 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultado el 10 de octubre de 2026)
Preguntas
¿Tiene superwhisper una CLI?
Sí, en macOS. El comando superwhisper busca y exporta tu historial, edita el vocabulario y controla la app en ejecución.
¿Cómo instalo la CLI de superwhisper?
Ejecuta con curl el script de instalación de su documentación. Instala en /usr/local/bin, o en ~/.local/bin si no se puede escribir en la primera.
¿Puedo iniciar una grabación de superwhisper desde Terminal?
Sí. superwhisper start, stop y record controlan la grabación, siempre que la app esté abierta.
¿Tiene superwhisper un servidor MCP?
Sí. superwhisper mcp ejecuta la CLI como servidor MCP por stdio, con herramientas para buscar, ver el historial, el vocabulario y los reemplazos.
¿Funciona la CLI de superwhisper en Windows?
No. Su documentación dice que la CLI solo está disponible en macOS.