CLI superwhisper: inštalácia, všetky príkazy a server MCP
Text: Ryleigh Newman · Zverejnené
superwhisper má pre Mac nástroj príkazového riadka, ktorý sa tiež volá superwhisper. Hľadá a exportuje vašu lokálnu históriu diktovania, upravuje slovník a náhrady a ovláda spustenú aplikáciu: spustí a zastaví nahrávanie, prepne režim, prepíše súbor. Môže bežať aj ako server MCP (Model Context Protocol), vďaka ktorému asistent AI vie hľadať vo vašich diktovaniach a čítať ich.
Vyvíjam YapToText, inú aplikáciu na diktovanie na Macu, preto čítajte všetko, čo píšem o superwhisper, s týmto vedomím. Každý údaj o superwhisper tu pochádza z jeho vlastnej dokumentácie podľa stavu k 10. októbru 2026. Ide o stránku CLI and MCP server.
Na stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.
Tento návod v ďalších jazykoch: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Inštalácia
curl -fsSL https://superwhisper.com/install-cli.sh | bashČo sa stane: Skript nainštaluje najnovšie vydanie do /usr/local/bin, alebo do ~/.local/bin, ak sa do prvého nedá zapisovať.
Ak shell potom nenájde superwhisper, pridajte ~/.local/bin do PATH. Dokumentácia uvádza, že binárne súbory a kontrolné súčty sú zverejnené v repozitári superultrainc/superwhisper-cli-release na GitHube, takže inštalačný skript si môžete prečítať skôr, než ho spustíte. CLI je len pre macOS.
Príkazy, ktoré čítajú históriu
Zo stránky dokumentácie superwhisper CLI and MCP server, stav k 10. októbru 2026. Čítajú tú istú lokálnu databázu ako aplikácia a bežia vo vašom zariadení.
| Príkaz | Čo robí |
|---|---|
| search | Fulltextové hľadanie vo všetkých prepisoch. Podporuje AND, OR, NOT, frázy v úvodzovkách a hviezdičku na konci predpony |
| history | Zobrazí posledné prepisy. Filtrujte pomocou --mode, --since a --before |
| read | Prečíta jeden prepis, najnovší, ak nezadáte ID. --raw ukáže text pred spracovaním pomocou AI |
| stats | Štatistiky prepisov |
| modes | Zobrazí režimy použité vo vašich nahrávkach s počtami |
| export | Exportuje všetko od najstaršieho, ako jsonl alebo markdown |
| vocab | Zobrazí, pridá alebo odstráni pojmy zo slovníka |
| snippets | Zobrazí, nastaví alebo odstráni náhrady, teda tie isté dvojice From a To ako v časti Settings, Vocabulary |
| doctor | Diagnostické informácie o databáze pre hlásenia chýb |
| completions | Vygeneruje dopĺňanie príkazov pre shell |
Príkazy, ktoré ovládajú aplikáciu
Z tej istej stránky. Posielajú požiadavku spustenej aplikácii, takže superwhisper musí byť otvorený.
| Príkaz | Čo robí |
|---|---|
| record | Prepne nahrávanie |
| start | Spustí nahrávanie. Nerobí nič, ak už nahráva |
| stop | Zastaví nahrávanie. Nerobí nič, ak nenahráva |
| switch | Prepne aktívny režim podľa názvu alebo kľúča. Bez argumentu zobrazí vaše režimy |
| settings | Otvorí okno nastavení |
| transcribe | Pošle zvukový súbor aplikácii na prepis. Prepis súboru vyžaduje plán Pro |
Príkazy start, stop a switch umožňujú ovládať superwhisper skriptom z čohokoľvek, čo vie spustiť príkaz shellu. Patrí sem spúšťač, nástroj na premapovanie klávesov alebo tlačidlo na rozhraní asistenčného spínača.
Príklady
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Čo sa stane: Každý riadok je jeden z vlastných príkladov z dokumentácie. Väčšina príkazov prijíma aj --json pre výstup, ktorý skript vie čítať.
Server MCP
superwhisper mcpČo sa stane: CLI hovorí protokolom MCP cez stdio a sprístupní nástroje na hľadanie, históriu, čítanie nahrávok, režimy, štatistiky, slovník a snippets.
Jedna poznámka k súkromiu z dokumentácie: samotné CLI beží celé vo vašom zariadení, ale keď je cez MCP pripojený asistent AI, prepisy, na ktoré sa pýta, sa posielajú tomuto asistentovi a spracúvajú sa podľa jeho vlastných nastavení modelu a údajov. Zvyšok opisuje stránka o súkromí v superwhisper.
YapToText a príkazový riadok
YapToText nemá nástroj príkazového riadka ani server MCP. Je to aplikácia v paneli s menu s jedným klávesom. Jeho stránka History exportuje celý zoznam ako obyčajný text alebo Markdown, čo pokrýva export bez Terminálu.
Na prepis z Terminálu bez akéhokoľvek nákupu je tu whisper.cpp, engine, na ktorom YapToText stojí. Návod na lokálny Whisper obsahuje príkazy a stránka o CLI MacWhisper opisuje nástroj inej aplikácie na súbory a priečinky.
Na stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.
Stručne
- Inštalácia. Jeden riadok curl, len macOS.
- Čítanie. search, history, read, stats a export.
- Ovládanie. record, start, stop, switch a transcribe, pri otvorenej aplikácii.
- MCP. superwhisper mcp, cez stdio.
- Súkromie. Lokálne, kým asistent nečíta prepisy cez MCP.
Ak superwhisper pridá alebo premenuje príkazy, založte issue na GitHube (po anglicky) a stránku aktualizujem. Čítam všetky.
Na stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.
Návody
Ďalšie návody, po anglicky
Zdroje
- https://superwhisper.com/docs/get-started/cli (overené 10. 10. 2026)
- https://superwhisper.com/docs/get-started/history (overené 10. 10. 2026)
- https://github.com/ryleighnewman/YapToText (overené 10. 10. 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (overené 10. 10. 2026)
Otázky
Má superwhisper CLI?
Áno, na macOS. Príkaz superwhisper hľadá a exportuje vašu históriu, upravuje slovník a ovláda spustenú aplikáciu.
Ako nainštalujem CLI superwhisper?
Spustite inštalačný skript z jeho dokumentácie pomocou curl. Nainštaluje sa do /usr/local/bin, alebo do ~/.local/bin, ak sa do prvého nedá zapisovať.
Dá sa nahrávanie superwhisper spustiť z Terminálu?
Áno. Príkazy superwhisper start, stop a record ovládajú nahrávanie, pokiaľ je aplikácia otvorená.
Má superwhisper server MCP?
Áno. Príkaz superwhisper mcp spustí CLI ako server MCP cez stdio s nástrojmi na hľadanie, históriu, slovník a snippets.
Funguje CLI superwhisper vo Windowse?
Nie. Jeho dokumentácia uvádza, že CLI je dostupné len na macOS.