A CLI do superwhisper: como instalar, todos os comandos e o servidor MCP
Por Ryleigh Newman · Publicado em
O superwhisper tem uma ferramenta de linha de comando para o Mac, que também se chama superwhisper. Ela busca e exporta o seu histórico local de ditados, edita o vocabulário e as substituições e controla o app em execução: iniciar, parar, trocar de modo, transcrever um arquivo. Ela também pode rodar como um servidor MCP (Model Context Protocol), que deixa um assistente de IA buscar e ler os seus ditados.
Eu crio o YapToText, outro app de ditado para o Mac, então leia o que digo sobre o superwhisper com isso em mente. Todo fato sobre o superwhisper aqui vem da documentação dele, consultada em 10 de outubro de 2026. A página é CLI and MCP server.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Este guia em outros idiomas: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Instalar
curl -fsSL https://superwhisper.com/install-cli.sh | bashO que acontece: O script instala a versão mais recente em /usr/local/bin, ou em ~/.local/bin se aquela pasta não aceitar gravação.
Se o seu shell não encontrar o superwhisper depois, adicione ~/.local/bin ao seu PATH. A documentação diz que os binários e os checksums são publicados no repositório superultrainc/superwhisper-cli-release, no GitHub, então você pode ler o script de instalação antes de executá-lo. A CLI é só para macOS.
Comandos que leem o seu histórico
Da página CLI and MCP server da documentação do superwhisper, consultada em 10 de outubro de 2026. Eles leem o mesmo banco de dados local do app e rodam no seu aparelho.
| Comando | O que faz |
|---|---|
| search | Busca em texto completo em todas as transcrições. Aceita AND, OR, NOT, frases entre aspas e um asterisco de prefixo |
| history | Lista as transcrições recentes. Filtre com --mode, --since e --before |
| read | Lê uma transcrição, a mais recente se você não informar um ID. --raw mostra o texto antes do processamento por IA |
| stats | Estatísticas das transcrições |
| modes | Lista os modos usados nas suas gravações, com as contagens |
| export | Exporta tudo, do mais antigo ao mais novo, como jsonl ou markdown |
| vocab | Lista, adiciona ou remove termos do vocabulário |
| snippets | Lista, define ou remove substituições, os mesmos pares From e To de Settings, Vocabulary |
| doctor | Informações de diagnóstico sobre o banco de dados, para relatórios de bug |
| completions | Gera os autocompletamentos do shell |
Comandos que controlam o app
Da mesma página. Eles enviam uma requisição ao app em execução, então o superwhisper precisa estar aberto.
| Comando | O que faz |
|---|---|
| record | Liga e desliga a gravação |
| start | Inicia a gravação. Não faz nada se já estiver gravando |
| stop | Para a gravação. Não faz nada se não estiver gravando |
| switch | Troca o modo ativo pelo nome ou pela chave. Sem argumento, lista os seus modos |
| settings | Abre a janela de ajustes |
| transcribe | Envia um arquivo de áudio ao app para transcrever. A transcrição de arquivos exige o Pro |
start, stop e switch tornam o superwhisper programável a partir de qualquer coisa que execute um comando de shell. Isso inclui um lançador, um remapeador de teclado ou um botão em uma interface de acionador assistivo.
Exemplos
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.m4aO que acontece: Cada linha é um dos exemplos da própria documentação. A maioria dos comandos também aceita --json, para uma saída que um script consiga ler.
O servidor MCP
superwhisper mcpO que acontece: A CLI fala MCP por stdio e expõe ferramentas de busca, histórico, leitura de gravações, modos, estatísticas, vocabulário e snippets.
Um ponto de privacidade da documentação: a CLI em si roda inteiramente no seu aparelho, mas, quando um assistente de IA está conectado por MCP, as transcrições que ele consulta são enviadas a esse assistente e tratadas pelo modelo e pelos ajustes de dados dele. A página de privacidade do superwhisper trata do resto.
O YapToText e a linha de comando
O YapToText não tem ferramenta de linha de comando nem servidor MCP. É um app da barra de menus com uma tecla. A página History dele exporta a lista inteira como texto simples ou Markdown, o que cobre o caso da exportação sem o Terminal.
Para transcrever pelo Terminal sem comprar nada, o whisper.cpp é o motor em que o YapToText se baseia. O guia do Whisper local traz os comandos, e a página sobre a CLI do MacWhisper trata da ferramenta de outro app para arquivos e pastas.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Resumindo
- Instalar. Uma linha com curl, só macOS.
- Ler. search, history, read, stats e export.
- Controlar. record, start, stop, switch e transcribe, com o app aberto.
- MCP. superwhisper mcp, por stdio.
- Privacidade. Local, até um assistente ler as transcrições por MCP.
Se o superwhisper adicionar ou renomear comandos, abra uma issue no GitHub e eu atualizo esta página. Todas são lidas.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Guias
Mais guias, em inglês
Fontes
- https://superwhisper.com/docs/get-started/cli (consultado em 10 de outubro de 2026)
- https://superwhisper.com/docs/get-started/history (consultado em 10 de outubro de 2026)
- https://github.com/ryleighnewman/YapToText (consultado em 10 de outubro de 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultado em 10 de outubro de 2026)
Perguntas
O superwhisper tem uma CLI?
Sim, no macOS. O comando superwhisper busca e exporta o seu histórico, edita o vocabulário e controla o app em execução.
Como instalar a CLI do superwhisper?
Execute com curl o script de instalação da documentação dele. Ele instala em /usr/local/bin, ou em ~/.local/bin se aquela pasta não aceitar gravação.
Dá para iniciar uma gravação do superwhisper pelo Terminal?
Sim. Os comandos superwhisper start, stop e record controlam a gravação, desde que o app esteja aberto.
O superwhisper tem um servidor MCP?
Sim. O comando superwhisper mcp executa a CLI como um servidor MCP por stdio, com ferramentas de busca, histórico, vocabulário e snippets.
A CLI do superwhisper funciona no Windows?
Não. A documentação dele diz que a CLI está disponível só para macOS.