CLI-ul superwhisper: cum îl instalați, fiecare comandă și serverul MCP
Text: Ryleigh Newman · Publicat la
superwhisper are un instrument de linie de comandă, numit tot superwhisper, pentru Mac. Caută în istoricul local al dictărilor și îl exportă, editează vocabularul și înlocuirile și controlează aplicația deschisă: pornire, oprire, schimbarea modului, transcrierea unui fișier. Poate rula și ca server MCP (Model Context Protocol), prin care un asistent AI poate căuta și citi dictările dvs.
Dezvolt YapToText, o altă aplicație de dictare pentru Mac, așa că țineți cont de asta când citiți ce spun despre superwhisper. Fiecare informație despre superwhisper de aici provine din documentația sa, citită la 10 octombrie 2026. Pagina este CLI and MCP server.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Acest ghid în alte limbi: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Instalarea
curl -fsSL https://superwhisper.com/install-cli.sh | bashCe se întâmplă: Scriptul instalează ultima versiune în /usr/local/bin sau în ~/.local/bin, dacă primul folder nu poate fi scris.
Dacă shell-ul nu găsește superwhisper după aceea, adăugați ~/.local/bin la PATH. Documentația spune că fișierele binare și sumele de control sunt publicate în depozitul superultrainc/superwhisper-cli-release de pe GitHub, deci puteți citi scriptul de instalare înainte să îl rulați. CLI-ul este numai pentru macOS.
Comenzile care citesc istoricul
Din pagina de documentație a superwhisper CLI and MCP server, citită la 10 octombrie 2026. Ele citesc aceeași bază de date locală ca aplicația și rulează pe dispozitivul dvs.
| Comanda | Ce face |
|---|---|
| search | Căutare în tot textul tuturor transcrierilor. Acceptă AND, OR, NOT, expresii între ghilimele și o stea de prefix |
| history | Listează transcrierile recente. Se filtrează cu --mode, --since și --before |
| read | Citește o transcriere, ultima dacă nu dați un ID. --raw arată textul dinainte de procesarea AI |
| stats | Statistici despre transcrieri |
| modes | Listează modurile folosite în înregistrările dvs., cu numărul fiecăruia |
| export | Exportă tot, de la cea mai veche, ca jsonl sau markdown |
| vocab | Listează, adaugă sau elimină termeni din vocabular |
| snippets | Listează, setează sau elimină înlocuiri, aceleași perechi From și To ca în Settings, Vocabulary |
| doctor | Informații de diagnosticare despre baza de date, pentru rapoarte de erori |
| completions | Generează completări pentru shell |
Comenzile care controlează aplicația
Din aceeași pagină. Ele trimit o cerere aplicației deschise, deci superwhisper trebuie să fie pornit.
| Comanda | Ce face |
|---|---|
| record | Pornește sau oprește înregistrarea |
| start | Pornește înregistrarea. Nu face nimic dacă se înregistrează deja |
| stop | Oprește înregistrarea. Nu face nimic dacă nu se înregistrează |
| switch | Schimbă modul activ după nume sau cheie. Fără argument, listează modurile dvs. |
| settings | Deschide fereastra de setări |
| transcribe | Trimite un fișier audio aplicației, ca să îl transcrie. Transcrierea fișierelor cere Pro |
start, stop și switch fac superwhisper controlabil prin script din orice poate rula o comandă shell. Asta include un launcher, un program de remapare a tastelor sau un buton de pe o interfață cu comutator pentru accesibilitate.
Exemple
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 se întâmplă: Fiecare linie este unul dintre exemplele din documentație. Majoritatea comenzilor acceptă și --json, pentru un rezultat pe care îl poate citi un script.
Serverul MCP
superwhisper mcpCe se întâmplă: CLI-ul vorbește MCP prin stdio și expune instrumente pentru căutare, istoric, citirea înregistrărilor, moduri, statistici, vocabular și snippets.
Un aspect de confidențialitate din documentație: CLI-ul în sine rulează în întregime pe dispozitivul dvs., dar atunci când un asistent AI este conectat prin MCP, transcrierile pe care le interoghează sunt trimise acelui asistent și tratate conform propriilor sale setări de model și de date. Pagina despre confidențialitatea superwhisper explică restul.
YapToText și linia de comandă
YapToText nu are instrument de linie de comandă și nici server MCP. Este o aplicație din bara de meniuri, cu o singură tastă. Pagina sa History exportă întreaga listă ca text simplu sau Markdown, ceea ce acoperă nevoia de export fără Terminal.
Pentru transcriere din Terminal, fără nimic de cumpărat, whisper.cpp este motorul pe care este construit YapToText. Ghidul despre Whisper local are comenzile, iar pagina despre CLI-ul MacWhisper descrie instrumentul altei aplicații pentru fișiere și foldere.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Pe scurt
- Instalare. O singură linie curl, numai macOS.
- Citire. search, history, read, stats și export.
- Control. record, start, stop, switch și transcribe, cu aplicația deschisă.
- MCP. superwhisper mcp, prin stdio.
- Confidențialitate. Local, până când un asistent citește transcrieri prin MCP.
Dacă superwhisper adaugă sau redenumește comenzi, deschideți un issue pe GitHub și voi actualiza pagina. Le citesc pe toate.
Descărcare gratuită. Fără cont și fără funcții blocate, pentru macOS 14 sau ulterior pe un Mac cu cip Apple. Codul sursă pe GitHub.
Ghiduri
Alte ghiduri, în engleză
Surse
- https://superwhisper.com/docs/get-started/cli (verificat la 10.10.2026)
- https://superwhisper.com/docs/get-started/history (verificat la 10.10.2026)
- https://github.com/ryleighnewman/YapToText (verificat la 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (verificat la 10.10.2026)
Întrebări
Are superwhisper un CLI?
Da, pe macOS. Comanda superwhisper caută în istoric și îl exportă, editează vocabularul și controlează aplicația deschisă.
Cum instalez CLI-ul superwhisper?
Rulați cu curl scriptul de instalare din documentația sa. El instalează în /usr/local/bin sau în ~/.local/bin, dacă primul folder nu poate fi scris.
Pot porni o înregistrare superwhisper din Terminal?
Da. superwhisper start, stop și record controlează înregistrarea, atât timp cât aplicația este deschisă.
Are superwhisper un server MCP?
Da. superwhisper mcp rulează CLI-ul ca server MCP prin stdio, cu instrumente pentru căutare, istoric, vocabular și snippets.
Funcționează CLI-ul superwhisper pe Windows?
Nu. Documentația sa spune că CLI-ul este disponibil numai pe macOS.