De superwhisper CLI: installeren, alle commando's en de MCP-server

Door · Gepubliceerd op

superwhisper heeft een opdrachtregeltool voor de Mac, die ook superwhisper heet. Die doorzoekt en exporteert je lokale dicteergeschiedenis, bewerkt vocabulaire en vervangingen en bestuurt de draaiende app: starten, stoppen, van modus wisselen en een bestand transcriberen. De tool kan ook als MCP-server (Model Context Protocol) draaien, zodat een AI-assistent je dictaten kan doorzoeken en lezen.

Ik maak YapToText, een andere dicteerapp voor de Mac, dus lees wat ik over superwhisper zeg met dat in gedachten. Elk feit over superwhisper op deze pagina komt uit de eigen docs, gelezen op 10 oktober 2026. De pagina is CLI and MCP server.

Download YapToText in de Mac App StoreGratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.

Deze handleiding in andere talen: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文

Installeren

curl -fsSL https://superwhisper.com/install-cli.sh | bash

Wat er gebeurt: Het script installeert de nieuwste versie in /usr/local/bin, of in ~/.local/bin als dat niet beschrijfbaar is.

Vindt je shell superwhisper daarna niet, voeg dan ~/.local/bin toe aan je PATH. Volgens de docs staan de binaire bestanden en checksums in de repository superultrainc/superwhisper-cli-release op GitHub, zodat je het installatiescript kunt lezen voordat je het uitvoert. De CLI is er alleen voor macOS.

Commando's die je geschiedenis lezen

Uit de docspagina CLI and MCP server van superwhisper, gelezen op 10 oktober 2026. Deze commando's lezen dezelfde lokale database als de app en draaien op je apparaat.

CommandoWat het doet
searchDoorzoekt alle transcripties op volledige tekst. Ondersteunt AND, OR, NOT, zinnen tussen aanhalingstekens en een ster aan het eind van een woord
historyToont recente transcripties. Filter met --mode, --since en --before
readLeest één transcriptie, de laatste als je geen ID geeft. --raw toont de tekst voordat de AI die bewerkt
statsStatistieken over transcripties
modesToont de modi die in je opnamen zijn gebruikt, met aantallen
exportExporteert alles, oudste eerst, als jsonl of markdown
vocabToont, voegt toe of verwijdert termen uit het vocabulaire
snippetsToont, stelt in of verwijdert vervangingen, dezelfde paren From en To als bij Settings, Vocabulary
doctorDiagnostische informatie over de database, voor bugrapporten
completionsMaakt aanvulling voor de shell

Commando's die de app besturen

Van dezelfde pagina. Deze commando's sturen een verzoek naar de draaiende app, dus superwhisper moet open zijn.

CommandoWat het doet
recordZet de opname aan of uit
startStart de opname. Doet niets als er al wordt opgenomen
stopStopt de opname. Doet niets als er niet wordt opgenomen
switchWisselt de actieve modus op naam of sleutel. Zonder argument toont het je modi
settingsOpent het instellingenvenster
transcribeStuurt een audiobestand naar de app om te transcriberen. Voor bestanden transcriberen is Pro nodig

Met start, stop en switch kun je superwhisper aansturen vanuit alles wat een shellcommando kan uitvoeren. Denk aan een launcher, een toetsenbordherschikker of een knop op een schakelaarinterface voor ondersteunende hulpmiddelen.

Voorbeelden

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.m4a

Wat er gebeurt: Elke regel is een eigen voorbeeld uit de docs. De meeste commando's accepteren ook --json voor uitvoer die een script kan lezen.

De MCP-server

superwhisper mcp

Wat er gebeurt: De CLI spreekt MCP via stdio en biedt tools voor zoeken, geschiedenis, opnamen lezen, modi, statistieken, vocabulaire en snippets.

Eén privacypunt uit de docs: de CLI zelf draait helemaal op je apparaat, maar zodra een AI-assistent via MCP is verbonden, worden de transcripten die die opvraagt naar die assistent gestuurd en verwerkt volgens zijn eigen model en data-instellingen. De privacypagina van superwhisper behandelt de rest.

YapToText en de opdrachtregel

YapToText heeft geen opdrachtregeltool en geen MCP-server. Het is een menubalkapp met één toets. De pagina History exporteert de hele lijst als platte tekst of Markdown, en dat dekt het exporteren zonder Terminal.

Voor transcriberen vanuit Terminal zonder iets te kopen is er whisper.cpp, de engine waarop YapToText is gebouwd. De gids voor lokale Whisper heeft de commando's, en de pagina over de MacWhisper CLI behandelt de tool van een andere app voor bestanden en mappen.

Download YapToText in de Mac App StoreGratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.

Kort samengevat

  • Installeren. Eén curl-regel, alleen macOS.
  • Lezen. search, history, read, stats en export.
  • Besturen. record, start, stop, switch en transcribe, met de app open.
  • MCP. superwhisper mcp, via stdio.
  • Privacy. Lokaal, tot een assistent transcripten leest via MCP.

Voegt superwhisper commando's toe of hernoemt het er, open dan een issue op GitHub en ik werk deze pagina bij. Ik lees ze allemaal.

Download YapToText in de Mac App StoreGratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.

Wie dit schrijft. Ryleigh Newman ontwikkelt software, kan moeilijk typen en dicteert elke dag met YapToText, de app die deze site beschrijft. Deze pagina is vertaald uit het Engels. De interface van de app en de rest van de site zijn in het Engels. Meer over het project, in het Engels.

Handleidingen

Meer handleidingen, in het Engels

Bronnen

Vragen

Heeft superwhisper een CLI?

Ja, op macOS. Het commando superwhisper doorzoekt en exporteert je geschiedenis, bewerkt vocabulaire en bestuurt de draaiende app.

Hoe installeer ik de superwhisper CLI?

Voer met curl het installatiescript uit de docs uit. Het installeert in /usr/local/bin, of in ~/.local/bin als dat niet beschrijfbaar is.

Kan ik vanuit Terminal een opname van superwhisper starten?

Ja. superwhisper start, stop en record besturen de opname, zolang de app open is.

Heeft superwhisper een MCP-server?

Ja. superwhisper mcp laat de CLI als MCP-server draaien via stdio, met tools voor zoeken, geschiedenis, vocabulaire en snippets.

Werkt de superwhisper CLI op Windows?

Nee. Volgens de docs is de CLI alleen beschikbaar voor macOS.