Die superwhisper CLI: Installation, alle Befehle und der MCP-Server
Von Ryleigh Newman · Veröffentlicht am
superwhisper hat für den Mac ein Kommandozeilenwerkzeug, das ebenfalls superwhisper heißt. Es durchsucht und exportiert deinen lokalen Diktatverlauf, pflegt Vokabular und Ersetzungen und steuert die laufende App: starten, stoppen, den Modus wechseln, eine Datei transkribieren. Es kann auch als MCP-Server (Model Context Protocol) laufen, sodass ein KI-Assistent deine Diktate durchsuchen und lesen kann.
Ich entwickle YapToText, eine andere Diktier-App für den Mac, lies also alles, was ich über superwhisper schreibe, mit diesem Wissen. Jede Angabe zu superwhisper stammt aus der eigenen Dokumentation, gelesen am 10. Oktober 2026. Die Seite heißt CLI and MCP server.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Diese Anleitung in anderen Sprachen: English, العربية, Čeština, Dansk, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Installieren
curl -fsSL https://superwhisper.com/install-cli.sh | bashWas passiert: Das Skript installiert die neueste Version in /usr/local/bin, oder in ~/.local/bin, wenn dort nicht geschrieben werden kann.
Findet deine Shell superwhisper danach nicht, füge ~/.local/bin zu deinem PATH hinzu. Laut Dokumentation werden Binärdateien und Prüfsummen im GitHub-Repository superultrainc/superwhisper-cli-release veröffentlicht, sodass du das Installationsskript lesen kannst, bevor du es ausführst. Die CLI gibt es nur für macOS.
Befehle, die deinen Verlauf lesen
Von der superwhisper-Dokumentationsseite CLI and MCP server, gelesen am 10. Oktober 2026. Diese Befehle lesen dieselbe lokale Datenbank wie die App und laufen auf deinem Gerät.
| Befehl | Was er tut |
|---|---|
| search | Volltextsuche über alle Transkriptionen. Unterstützt AND, OR, NOT, Phrasen in Anführungszeichen und einen Stern als Präfix |
| history | Listet die letzten Transkriptionen auf. Filtere mit --mode, --since und --before |
| read | Liest eine Transkription, die neueste, wenn du keine ID angibst. --raw zeigt den Text vor der KI-Verarbeitung |
| stats | Statistiken zu den Transkriptionen |
| modes | Listet die in deinen Aufnahmen verwendeten Modi mit Anzahl auf |
| export | Exportiert alles, das Älteste zuerst, als jsonl oder markdown |
| vocab | Listet Vokabeln auf, fügt sie hinzu oder entfernt sie |
| snippets | Listet Ersetzungen auf, legt sie fest oder entfernt sie, dieselben Paare aus From und To wie unter Settings, Vocabulary |
| doctor | Diagnoseinformationen zur Datenbank, für Fehlerberichte |
| completions | Erzeugt Shell-Vervollständigungen |
Befehle, die die App steuern
Von derselben Seite. Diese Befehle senden eine Anfrage an die laufende App, superwhisper muss also geöffnet sein.
| Befehl | Was er tut |
|---|---|
| record | Schaltet die Aufnahme um |
| start | Startet die Aufnahme. Tut nichts, wenn schon aufgenommen wird |
| stop | Beendet die Aufnahme. Tut nichts, wenn nicht aufgenommen wird |
| switch | Wechselt den aktiven Modus nach Name oder Taste. Ohne Argument listet er deine Modi auf |
| settings | Öffnet das Einstellungsfenster |
| transcribe | Sendet eine Audiodatei zur Transkription an die App. Die Dateitranskription braucht Pro |
Mit start, stop und switch lässt sich superwhisper von allem aus skripten, was einen Shell-Befehl ausführen kann. Dazu gehören ein Launcher, ein Tastatur-Remapper oder eine Taste an einer Schalter-Schnittstelle für Menschen mit Behinderung.
Beispiele
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.m4aWas passiert: Jede Zeile ist eines der eigenen Beispiele der Dokumentation. Die meisten Befehle akzeptieren auch --json für eine Ausgabe, die ein Skript lesen kann.
Der MCP-Server
superwhisper mcpWas passiert: Die CLI spricht MCP über stdio und stellt Werkzeuge für Suche, Verlauf, das Lesen von Aufnahmen, Modi, Statistiken, Vokabular und Snippets bereit.
Ein Datenschutzhinweis aus der Dokumentation: Die CLI selbst läuft vollständig auf deinem Gerät, aber wenn ein KI-Assistent über MCP verbunden ist, werden die Transkripte, die er abfragt, an diesen Assistenten gesendet und nach dessen eigenen Modell- und Dateneinstellungen behandelt. Die Datenschutzseite zu superwhisper behandelt den Rest.
YapToText und die Kommandozeile
YapToText hat kein Kommandozeilenwerkzeug und keinen MCP-Server. Es ist eine App in der Menüleiste mit einer Taste. Die Seite History exportiert die ganze Liste als reinen Text oder als Markdown, womit der Export ohne Terminal abgedeckt ist.
Für die Transkription im Terminal, ohne etwas zu kaufen, gibt es whisper.cpp, die Engine, auf der YapToText aufbaut. Der Leitfaden zu lokalem Whisper hat die Befehle, und die Seite zur MacWhisper CLI behandelt das Werkzeug einer anderen App für Dateien und Ordner.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Kurz gesagt
- Installation. Eine curl-Zeile, nur macOS.
- Lesen. search, history, read, stats und export.
- Steuern. record, start, stop, switch und transcribe, bei geöffneter App.
- MCP. superwhisper mcp, über stdio.
- Datenschutz. Lokal, bis ein Assistent Transkripte über MCP liest.
Wenn superwhisper Befehle hinzufügt oder umbenennt, eröffne ein Issue auf GitHub, und ich aktualisiere diese Seite. Ich lese jedes.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Anleitungen
Weitere Anleitungen, auf Englisch
Quellen
- https://superwhisper.com/docs/get-started/cli (geprüft am 10. Oktober 2026)
- https://superwhisper.com/docs/get-started/history (geprüft am 10. Oktober 2026)
- https://github.com/ryleighnewman/YapToText (geprüft am 10. Oktober 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (geprüft am 10. Oktober 2026)
Fragen
Hat superwhisper eine CLI?
Ja, unter macOS. Der Befehl superwhisper durchsucht und exportiert deinen Verlauf, pflegt das Vokabular und steuert die laufende App.
Wie installiere ich die superwhisper CLI?
Führe das Installationsskript aus der Dokumentation mit curl aus. Es installiert nach /usr/local/bin, oder nach ~/.local/bin, wenn dort nicht geschrieben werden kann.
Kann ich eine superwhisper-Aufnahme im Terminal starten?
Ja. superwhisper start, stop und record steuern die Aufnahme, solange die App geöffnet ist.
Hat superwhisper einen MCP-Server?
Ja. superwhisper mcp führt die CLI als MCP-Server über stdio aus, mit Werkzeugen für Suche, Verlauf, Vokabular und Snippets.
Funktioniert die superwhisper CLI unter Windows?
Nein. Laut Dokumentation gibt es die CLI nur für macOS.