CLI superwhisper: instalacja, wszystkie polecenia i serwer MCP
Tekst: Ryleigh Newman · Opublikowano
superwhisper ma narzędzie wiersza poleceń na Maca, które nazywa się tak samo, superwhisper. Przeszukuje i eksportuje lokalną historię dyktowania, edytuje słownik i zamienniki oraz steruje uruchomioną aplikacją: zaczyna i kończy nagrywanie, przełącza tryb, transkrybuje plik. Może też działać jako serwer MCP (Model Context Protocol), dzięki któremu asystent AI przeszukuje i czyta Twoje dyktowania.
Tworzę YapToText, inną aplikację do dyktowania na Maca, więc czytaj to, co piszę o superwhisper, z tą wiedzą. Każdy fakt o superwhisper pochodzi z jego dokumentacji, czytanej 10 października 2026. Ta strona to CLI and MCP server.
Do pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.
Ten poradnik w innych językach: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Instalacja
curl -fsSL https://superwhisper.com/install-cli.sh | bashCo się dzieje: Skrypt instaluje najnowszą wersję w /usr/local/bin albo w ~/.local/bin, jeśli do pierwszego nie można zapisywać.
Jeśli po instalacji powłoka nie znajduje polecenia superwhisper, dodaj ~/.local/bin do PATH. Dokumentacja podaje, że pliki binarne i sumy kontrolne są publikowane w repozytorium superultrainc/superwhisper-cli-release na GitHubie, więc skrypt instalacyjny można przeczytać przed uruchomieniem. CLI jest tylko dla macOS.
Polecenia, które czytają historię
Ze strony dokumentacji superwhisper CLI and MCP server, czytanej 10 października 2026. Czytają tę samą lokalną bazę co aplikacja i działają na Twoim urządzeniu.
| Polecenie | Co robi |
|---|---|
| search | Wyszukiwanie pełnotekstowe we wszystkich transkrypcjach. Obsługuje AND, OR, NOT, frazy w cudzysłowie i gwiazdkę na końcu słowa |
| history | Wypisuje ostatnie transkrypcje. Filtruj za pomocą --mode, --since i --before |
| read | Czyta jedną transkrypcję, a bez podanego ID ostatnią. --raw pokazuje tekst sprzed przetwarzania przez AI |
| stats | Statystyki transkrypcji |
| modes | Wypisuje tryby użyte w Twoich nagraniach, z liczbami |
| export | Eksportuje wszystko, od najstarszych, jako jsonl lub markdown |
| vocab | Wypisuje, dodaje lub usuwa pojęcia ze słownika |
| snippets | Wypisuje, ustawia lub usuwa zamienniki, czyli te same pary From i To co w Settings, Vocabulary |
| doctor | Informacje diagnostyczne o bazie danych, do zgłoszeń błędów |
| completions | Generuje podpowiedzi dla powłoki |
Polecenia, które sterują aplikacją
Z tej samej strony. Wysyłają żądanie do uruchomionej aplikacji, więc superwhisper musi być otwarty.
| Polecenie | Co robi |
|---|---|
| record | Przełącza nagrywanie |
| start | Zaczyna nagrywanie. Nic nie robi, jeśli nagrywanie już trwa |
| stop | Kończy nagrywanie. Nic nie robi, jeśli nic nie jest nagrywane |
| switch | Przełącza aktywny tryb według nazwy lub klucza. Bez argumentu wypisuje Twoje tryby |
| settings | Otwiera okno ustawień |
| transcribe | Wysyła plik audio do aplikacji, żeby go transkrybowała. Transkrypcja plików wymaga planu Pro |
Polecenia start, stop i switch pozwalają sterować superwhisper skryptem z wszystkiego, co potrafi uruchomić polecenie powłoki. To także program uruchamiający, narzędzie do przemapowania klawiszy albo przycisk w interfejsie przełącznika wspomagającego.
Przykłady
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.m4aCo się dzieje: Każdy wiersz to jeden z przykładów z samej dokumentacji. Większość poleceń przyjmuje też --json, żeby uzyskać wynik czytelny dla skryptu.
Serwer MCP
superwhisper mcpCo się dzieje: CLI mówi protokołem MCP przez stdio i udostępnia narzędzia do wyszukiwania, historii, czytania nagrań, trybów, statystyk, słownika i zamienników.
Jedna uwaga o prywatności z dokumentacji: samo CLI działa w całości na Twoim urządzeniu, ale gdy asystent AI jest połączony przez MCP, transkrypcje, o które pyta, trafiają do tego asystenta i są obsługiwane według jego własnych ustawień modelu i danych. Resztę opisuje strona o prywatności superwhisper.
YapToText i wiersz poleceń
YapToText nie ma narzędzia wiersza poleceń ani serwera MCP. To aplikacja na pasku menu z jednym klawiszem. Jego strona History eksportuje całą listę jako zwykły tekst lub Markdown, co załatwia eksport bez Terminala.
Do transkrypcji z Terminala, bez niczego do kupienia, służy whisper.cpp, silnik, na którym zbudowany jest YapToText. Poradnik o lokalnym Whisper zawiera polecenia, a strona o CLI MacWhisper opisuje narzędzie innej aplikacji do plików i folderów.
Do pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.
W skrócie
- Instalacja. Jedna linia curl, tylko macOS.
- Czytanie. search, history, read, stats i export.
- Sterowanie. record, start, stop, switch i transcribe, przy otwartej aplikacji.
- MCP. superwhisper mcp, przez stdio.
- Prywatność. Lokalnie, dopóki asystent nie czyta transkrypcji przez MCP.
Jeśli superwhisper doda polecenia lub zmieni ich nazwy, zgłoś to na GitHubie, a zaktualizuję tę stronę. Czytam każde zgłoszenie.
Do pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.
Poradniki
Więcej poradników, po angielsku
Źródła
- https://superwhisper.com/docs/get-started/cli (sprawdzono 10 października 2026)
- https://superwhisper.com/docs/get-started/history (sprawdzono 10 października 2026)
- https://github.com/ryleighnewman/YapToText (sprawdzono 10 października 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (sprawdzono 10 października 2026)
Pytania
Czy superwhisper ma CLI?
Tak, na macOS. Polecenie superwhisper przeszukuje i eksportuje historię, edytuje słownik oraz steruje uruchomioną aplikacją.
Jak zainstalować CLI superwhisper?
Uruchom skrypt instalacyjny z jego dokumentacji przez curl. Instaluje on w /usr/local/bin albo w ~/.local/bin, jeśli do pierwszego nie można zapisywać.
Czy można uruchomić nagrywanie superwhisper z Terminala?
Tak. Polecenia superwhisper start, stop i record sterują nagrywaniem, o ile aplikacja jest otwarta.
Czy superwhisper ma serwer MCP?
Tak. Polecenie superwhisper mcp uruchamia CLI jako serwer MCP przez stdio, z narzędziami do wyszukiwania, historii, słownika i zamienników.
Czy CLI superwhisper działa na Windows?
Nie. Jego dokumentacja podaje, że CLI jest dostępne tylko na macOS.