La CLI de superwhisper : l'installer, toutes les commandes et le serveur MCP
Par Ryleigh Newman · Publié le
superwhisper a un outil en ligne de commande, qui s'appelle aussi superwhisper, pour le Mac. Il cherche dans votre historique de dictées local et l'exporte, modifie le vocabulaire et les remplacements, et pilote l'app en cours d'exécution : démarrer, arrêter, changer de mode, transcrire un fichier. Il peut aussi tourner comme serveur MCP (Model Context Protocol), ce qui permet à un assistant IA de chercher dans vos dictées et de les lire.
Je crée YapToText, une autre app de dictée pour Mac, donc lisez ce que je dis de superwhisper en le sachant. Tous les faits sur superwhisper viennent de sa propre documentation, lue le 10 octobre 2026. La page est CLI and MCP server.
Téléchargement gratuit. Sans compte, sans rien de verrouillé, pour macOS 14 ou ultérieur sur un Mac avec puce Apple. Code source sur GitHub.
Ce guide dans d'autres langues : English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
L'installer
curl -fsSL https://superwhisper.com/install-cli.sh | bashCe qui se passe : Le script installe la dernière version dans /usr/local/bin, ou dans ~/.local/bin si ce dossier n'est pas accessible en écriture.
Si votre shell ne trouve pas superwhisper ensuite, ajoutez ~/.local/bin à votre PATH. La documentation dit que les binaires et les sommes de contrôle sont publiés dans le dépôt superultrainc/superwhisper-cli-release sur GitHub, donc vous pouvez lire le script d'installation avant de l'exécuter. La CLI ne fonctionne que sur macOS.
Les commandes qui lisent votre historique
D'après la page CLI and MCP server de la documentation de superwhisper, lue le 10 octobre 2026. Elles lisent la même base de données locale que l'app et s'exécutent sur votre appareil.
| Commande | Ce qu'elle fait |
|---|---|
| search | Recherche en texte intégral dans toutes les transcriptions. Accepte AND, OR, NOT, les expressions entre guillemets et une étoile de préfixe |
| history | Liste les transcriptions récentes. Filtrez avec --mode, --since et --before |
| read | Lit une transcription, la dernière si vous ne donnez pas d'identifiant. --raw affiche le texte avant le traitement par l'IA |
| stats | Statistiques sur les transcriptions |
| modes | Liste les modes utilisés dans vos enregistrements, avec leur nombre |
| export | Exporte tout, du plus ancien au plus récent, en jsonl ou en markdown |
| vocab | Liste, ajoute ou retire des termes du vocabulaire |
| snippets | Liste, définit ou retire des remplacements, les mêmes paires From et To que dans Settings, Vocabulary |
| doctor | Informations de diagnostic sur la base de données, pour les rapports de bogue |
| completions | Génère les complétions du shell |
Les commandes qui pilotent l'app
D'après la même page. Elles envoient une requête à l'app en cours d'exécution, donc superwhisper doit être ouvert.
| Commande | Ce qu'elle fait |
|---|---|
| record | Active ou désactive l'enregistrement |
| start | Démarre l'enregistrement. Ne fait rien s'il est déjà en cours |
| stop | Arrête l'enregistrement. Ne fait rien s'il n'est pas en cours |
| switch | Change le mode actif par son nom ou sa clé. Sans argument, liste vos modes |
| settings | Ouvre la fenêtre des réglages |
| transcribe | Envoie un fichier audio à l'app pour le transcrire. La transcription de fichiers demande l'offre Pro |
start, stop et switch rendent superwhisper pilotable par un script depuis tout ce qui peut lancer une commande de shell. Cela inclut un lanceur, un outil de remappage du clavier ou un bouton sur une interface à contacteur d'accessibilité.
Exemples
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.m4aCe qui se passe : Chaque ligne est un des exemples de la documentation. La plupart des commandes acceptent aussi --json pour une sortie qu'un script peut lire.
Le serveur MCP
superwhisper mcpCe qui se passe : La CLI parle MCP par stdio et expose des outils pour la recherche, l'historique, la lecture des enregistrements, les modes, les statistiques, le vocabulaire et les snippets.
Un point de confidentialité tiré de la documentation : la CLI elle-même tourne entièrement sur votre appareil, mais lorsqu'un assistant IA est connecté par MCP, les transcriptions qu'il interroge lui sont envoyées et traitées selon ses propres réglages de modèle et de données. La page sur la confidentialité de superwhisper couvre le reste.
YapToText et la ligne de commande
YapToText n'a ni outil en ligne de commande ni serveur MCP. C'est une app de barre des menus avec une seule touche. Sa page History exporte toute la liste en texte brut ou en Markdown, ce qui répond au besoin d'export sans Terminal.
Pour transcrire depuis le Terminal sans rien acheter, whisper.cpp est le moteur sur lequel YapToText est construit. Le guide de Whisper en local donne les commandes, et la page sur la CLI de MacWhisper présente l'outil d'une autre app pour les fichiers et les dossiers.
Téléchargement gratuit. Sans compte, sans rien de verrouillé, pour macOS 14 ou ultérieur sur un Mac avec puce Apple. Code source sur GitHub.
En bref
- Installer. Une ligne curl, macOS uniquement.
- Lire. search, history, read, stats et export.
- Piloter. record, start, stop, switch et transcribe, avec l'app ouverte.
- MCP. superwhisper mcp, par stdio.
- Confidentialité. Locale, jusqu'à ce qu'un assistant lise des transcriptions par MCP.
Si superwhisper ajoute ou renomme des commandes, ouvrez une issue sur GitHub et je mettrai cette page à jour. Je les lis toutes.
Téléchargement gratuit. Sans compte, sans rien de verrouillé, pour macOS 14 ou ultérieur sur un Mac avec puce Apple. Code source sur GitHub.
Guides
Autres guides, en anglais
Sources
- https://superwhisper.com/docs/get-started/cli (consulté le 10 octobre 2026)
- https://superwhisper.com/docs/get-started/history (consulté le 10 octobre 2026)
- https://github.com/ryleighnewman/YapToText (consulté le 10 octobre 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consulté le 10 octobre 2026)
Questions
superwhisper a-t-il une CLI ?
Oui, sur macOS. La commande superwhisper cherche dans votre historique et l'exporte, modifie le vocabulaire et pilote l'app en cours d'exécution.
Comment installer la CLI de superwhisper ?
Lancez avec curl le script d'installation de sa documentation. Il installe dans /usr/local/bin, ou dans ~/.local/bin si ce dossier n'est pas accessible en écriture.
Peut-on démarrer un enregistrement superwhisper depuis le Terminal ?
Oui. superwhisper start, stop et record pilotent l'enregistrement, tant que l'app est ouverte.
superwhisper a-t-il un serveur MCP ?
Oui. superwhisper mcp lance la CLI comme serveur MCP par stdio, avec des outils pour la recherche, l'historique, le vocabulaire et les snippets.
La CLI de superwhisper fonctionne-t-elle sur Windows ?
Non. Sa documentation dit que la CLI n'existe que sur macOS.