superwhisperin CLI: asennus, jokainen komento ja MCP-palvelin
Teksti: Ryleigh Newman · Julkaistu
superwhisperilla on Macille komentorivityökalu, jonka nimi on myös superwhisper. Se hakee ja vie paikallisen sanelun historiasi, muokkaa sanastoa ja korvauksia ja ohjaa käynnissä olevaa appia: aloita, lopeta, vaihda tilaa, litteroi tiedosto. Se voi toimia myös MCP-palvelimena (Model Context Protocol), jolloin tekoälyavustaja voi hakea ja lukea sanelujasi.
Teen YapToTextia, toista sanelusovellusta Macille, joten lue superwhisperista kirjoittamani sitä silmällä pitäen. Kaikki superwhisperia koskevat tiedot tällä sivulla ovat sen omista ohjeista, jotka luin 10. lokakuuta 2026. Sivu on CLI and MCP server.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Tämä opas muilla kielillä: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Asenna se
curl -fsSL https://superwhisper.com/install-cli.sh | bashMitä tapahtuu: Skripti asentaa uusimman version kansioon /usr/local/bin tai kansioon ~/.local/bin, jos edellinen ei ole kirjoitettavissa.
Jos komentotulkkisi ei löydä superwhisperia asennuksen jälkeen, lisää ~/.local/bin PATH-muuttujaan. Ohjeiden mukaan binäärit ja tarkistussummat julkaistaan GitHubin arkistossa superultrainc/superwhisper-cli-release, joten voit lukea asennusskriptin ennen sen ajamista. CLI on vain macOS:lle.
Historiaasi lukevat komennot
superwhisperin ohjesivulta CLI and MCP server, luettuna 10. lokakuuta 2026. Nämä lukevat samaa paikallista tietokantaa kuin appi ja toimivat laitteellasi.
| Komento | Mitä se tekee |
|---|---|
| search | Kokotekstihaku kaikista litteroinneista. Tukee operaattoreita AND, OR ja NOT, lainattuja fraaseja ja etuliitetähteä |
| history | Listaa viimeisimmät litteroinnit. Suodata valinnoilla --mode, --since ja --before |
| read | Lukee yhden litteroinnin, uusimman, jos et anna tunnistetta. --raw näyttää tekstin ennen tekoälykäsittelyä |
| stats | Litterointien tilastot |
| modes | Listaa äänitteissäsi käytetyt tilat lukumäärineen |
| export | Vie kaiken, vanhimmasta alkaen, muodossa jsonl tai markdown |
| vocab | Listaa, lisää tai poistaa sanaston termejä |
| snippets | Listaa, asettaa tai poistaa korvauksia, samat parit (kentät From ja To) kuin kohdassa Settings, Vocabulary |
| doctor | Diagnostiikkatietoja tietokannasta virheraportteja varten |
| completions | Luo komentotulkin täydennykset |
Appia ohjaavat komennot
Samalta sivulta. Nämä lähettävät pyynnön käynnissä olevalle apille, joten superwhisperin on oltava auki.
| Komento | Mitä se tekee |
|---|---|
| record | Vaihtaa äänityksen päälle tai pois |
| start | Aloittaa äänityksen. Ei tee mitään, jos äänitys on jo käynnissä |
| stop | Lopettaa äänityksen. Ei tee mitään, jos äänitystä ei ole käynnissä |
| switch | Vaihtaa aktiivisen tilan nimen tai avaimen mukaan. Ilman argumenttia listaa tilasi |
| settings | Avaa asetusikkunan |
| transcribe | Lähettää äänitiedoston apille litteroitavaksi. Tiedoston litterointi vaatii tason Pro |
Komennot start, stop ja switch tekevät superwhisperista skriptattavan kaikesta, mikä osaa ajaa komentotulkin komennon. Siihen kuuluvat käynnistin, näppäinten uudelleenmäärittäjä tai avustavan kytkinkäyttöliittymän painike.
Esimerkkejä
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.m4aMitä tapahtuu: Jokainen rivi on yksi ohjeiden omista esimerkeistä. Useimmat komennot hyväksyvät myös valinnan --json, jolloin tuloste on skriptin luettavissa.
MCP-palvelin
superwhisper mcpMitä tapahtuu: CLI puhuu MCP:tä stdio-yhteyden yli ja tarjoaa työkalut hakuun, historiaan, äänitteiden lukemiseen, tiloihin, tilastoihin, sanastoon ja korvauksiin (snippets).
Yksi tietosuojakohta ohjeista: CLI toimii kokonaan laitteellasi, mutta kun tekoälyavustaja on yhdistetty MCP:n kautta, sen kyselemät litteroinnit lähetetään kyseiselle avustajalle ja käsitellään sen omien mallia ja dataa koskevien asetusten mukaan. superwhisperin tietosuojasivu kertoo lopun.
YapToText ja komentorivi
YapToTextissa ei ole komentorivityökalua eikä MCP-palvelinta. Se on valikkorivin appi, jossa on yksi näppäin. Sen sivu History vie koko listan pelkkänä tekstinä tai Markdown-muodossa, mikä kattaa viennin ilman Terminalia.
Jos haluat litteroida Terminalista eikä mitään tarvitse ostaa, whisper.cpp on moottori, jolle YapToText on rakennettu. Paikallisen Whisperin opas sisältää komennot, ja MacWhisperin CLI-sivu käsittelee toisen apin työkalua tiedostoille ja kansioille.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Lyhyt versio
- Asennus. Yksi curl-rivi, vain macOS.
- Lukeminen. search, history, read, stats ja export.
- Ohjaus. record, start, stop, switch ja transcribe, kun appi on auki.
- MCP. superwhisper mcp, stdio-yhteyden yli.
- Tietosuoja. Paikallinen, kunnes avustaja lukee litteroinnit MCP:n kautta.
Jos superwhisper lisää komentoja tai nimeää niitä uudelleen, avaa issue GitHub-palvelussa (englanniksi), niin päivitän tämän sivun. Luen jokaisen.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Oppaat
Lisää oppaita, englanniksi
Lähteet
- https://superwhisper.com/docs/get-started/cli (tarkistettu 10.10.2026)
- https://superwhisper.com/docs/get-started/history (tarkistettu 10.10.2026)
- https://github.com/ryleighnewman/YapToText (tarkistettu 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (tarkistettu 10.10.2026)
Kysymyksiä
Onko superwhisperilla CLI?
Kyllä, macOS:llä. Komento superwhisper hakee ja vie historiasi, muokkaa sanastoa ja ohjaa käynnissä olevaa appia.
Miten asennan superwhisperin CLI:n?
Aja ohjeiden asennusskripti curlilla. Se asentaa kansioon /usr/local/bin tai kansioon ~/.local/bin, jos edellinen ei ole kirjoitettavissa.
Voinko aloittaa superwhisperin äänityksen Terminalista?
Kyllä. Komennot superwhisper start, stop ja record ohjaavat äänitystä, kunhan appi on auki.
Onko superwhisperilla MCP-palvelin?
Kyllä. Komento superwhisper mcp ajaa CLI:n MCP-palvelimena stdio-yhteyden yli, ja työkaluina ovat haku, historia, sanasto ja korvaukset.
Toimiiko superwhisperin CLI Windowsissa?
Ei. Sen ohjeiden mukaan CLI on saatavilla vain macOS:lle.