La CLI di superwhisper: come installarla, ogni comando e il server MCP
Di Ryleigh Newman · Pubblicato il
superwhisper ha uno strumento da riga di comando per Mac, che si chiama anch'esso superwhisper. Cerca ed esporta la cronologia locale delle tue dettature, modifica vocabolario e sostituzioni e controlla l'app in esecuzione: avvia, ferma, cambia modalità, trascrive un file. Può anche funzionare come server MCP (Model Context Protocol), che permette a un assistente IA di cercare e leggere le tue dettature.
Io creo YapToText, un'altra app di dettatura per Mac, quindi leggi ciò che dico su superwhisper tenendolo presente. Ogni fatto su superwhisper qui riportato viene dalla sua documentazione, letta il 10 ottobre 2026. La pagina è CLI and MCP server.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
Questa guida in altre lingue: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Installarla
curl -fsSL https://superwhisper.com/install-cli.sh | bashCosa succede: Lo script installa l'ultima versione in /usr/local/bin, oppure in ~/.local/bin se la prima non è scrivibile.
Se dopo l'installazione la shell non trova superwhisper, aggiungi ~/.local/bin al tuo PATH. La documentazione dice che i file binari e i checksum sono pubblicati nel repository superultrainc/superwhisper-cli-release su GitHub, quindi puoi leggere lo script di installazione prima di eseguirlo. La CLI è solo per macOS.
I comandi che leggono la cronologia
Dalla pagina CLI and MCP server della documentazione di superwhisper, letta il 10 ottobre 2026. Leggono lo stesso database locale dell'app e girano sul tuo dispositivo.
| Comando | Cosa fa |
|---|---|
| search | Ricerca a testo pieno in tutte le trascrizioni. Supporta AND, OR, NOT, frasi tra virgolette e un asterisco come prefisso |
| history | Elenca le trascrizioni recenti. Filtra con --mode, --since e --before |
| read | Legge una trascrizione, l'ultima se non dai alcun ID. --raw mostra il testo prima dell'elaborazione dell'IA |
| stats | Statistiche sulle trascrizioni |
| modes | Elenca le modalità usate nelle tue registrazioni, con i conteggi |
| export | Esporta tutto, dalla più vecchia, come jsonl o markdown |
| vocab | Elenca, aggiunge o rimuove termini del vocabolario |
| snippets | Elenca, imposta o rimuove le sostituzioni, le stesse coppie From e To di Settings, Vocabulary |
| doctor | Informazioni diagnostiche sul database, per le segnalazioni di errori |
| completions | Genera i completamenti per la shell |
I comandi che controllano l'app
Dalla stessa pagina. Inviano una richiesta all'app in esecuzione, quindi superwhisper deve essere aperto.
| Comando | Cosa fa |
|---|---|
| record | Attiva o disattiva la registrazione |
| start | Avvia la registrazione. Non fa nulla se sta già registrando |
| stop | Ferma la registrazione. Non fa nulla se non sta registrando |
| switch | Cambia la modalità attiva per nome o per chiave. Senza argomento, elenca le tue modalità |
| settings | Apre la finestra delle impostazioni |
| transcribe | Invia un file audio all'app da trascrivere. La trascrizione di file richiede Pro |
start, stop e switch rendono superwhisper programmabile da qualsiasi cosa possa eseguire un comando di shell. Per esempio un launcher, un programma che rimappa la tastiera o un pulsante di un'interfaccia a interruttore per l'accessibilità.
Esempi
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.m4aCosa succede: Ogni riga è uno degli esempi della documentazione. La maggior parte dei comandi accetta anche --json per un output che uno script può leggere.
Il server MCP
superwhisper mcpCosa succede: La CLI parla MCP su stdio ed espone strumenti per cercare, consultare la cronologia, leggere le registrazioni, le modalità, le statistiche, il vocabolario e gli snippet.
Un punto sulla privacy, dalla documentazione: la CLI in sé gira interamente sul tuo dispositivo, ma quando un assistente IA è collegato tramite MCP, le trascrizioni che interroga vengono inviate a quell'assistente e trattate secondo le sue impostazioni su modello e dati. La pagina sulla privacy di superwhisper spiega il resto.
YapToText e la riga di comando
YapToText non ha uno strumento da riga di comando né un server MCP. È un'app nella barra dei menu con un solo tasto. La sua pagina History esporta l'intero elenco come testo semplice o Markdown, il che copre l'esportazione senza Terminale.
Per trascrivere da Terminale senza spendere nulla, whisper.cpp è il motore su cui è costruita YapToText. La guida a Whisper in locale ha i comandi, e la pagina sulla CLI di MacWhisper tratta lo strumento di un'altra app per file e cartelle.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
In breve
- Installazione. Una riga con curl, solo macOS.
- Lettura. search, history, read, stats ed export.
- Controllo. record, start, stop, switch e transcribe, con l'app aperta.
- MCP. superwhisper mcp, su stdio.
- Privacy. In locale, finché un assistente non legge le trascrizioni tramite MCP.
Se superwhisper aggiunge o rinomina dei comandi, apri una issue su GitHub e aggiornerò questa pagina. Le leggo tutte.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
Guide
Altre guide, in inglese
Fonti
- https://superwhisper.com/docs/get-started/cli (consultato il 10 ottobre 2026)
- https://superwhisper.com/docs/get-started/history (consultato il 10 ottobre 2026)
- https://github.com/ryleighnewman/YapToText (consultato il 10 ottobre 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultato il 10 ottobre 2026)
Domande
superwhisper ha una CLI?
Sì, su macOS. Il comando superwhisper cerca ed esporta la tua cronologia, modifica il vocabolario e controlla l'app in esecuzione.
Come si installa la CLI di superwhisper?
Esegui con curl lo script di installazione della sua documentazione. Installa in /usr/local/bin, oppure in ~/.local/bin se la prima non è scrivibile.
Posso avviare una registrazione di superwhisper da Terminale?
Sì. superwhisper start, stop e record controllano la registrazione, purché l'app sia aperta.
superwhisper ha un server MCP?
Sì. superwhisper mcp esegue la CLI come server MCP su stdio, con strumenti per ricerca, cronologia, vocabolario e snippet.
La CLI di superwhisper funziona su Windows?
No. La sua documentazione dice che la CLI è disponibile solo su macOS.