superwhisper CLI: nasıl kurulur, tüm komutlar ve MCP sunucusu
Yazan: Ryleigh Newman · Yayımlanma:
superwhisper’ın Mac için yine superwhisper adlı bir komut satırı aracı vardır. Yerel dikte geçmişinizi arar ve dışa aktarır, sözlüğü ve metin değiştirmeleri düzenler, çalışan uygulamayı denetler: başlatır, durdurur, modu değiştirir, bir dosyayı yazıya döker. Ayrıca bir yapay zekâ asistanının dikte kayıtlarınızı aramasına ve okumasına izin veren bir MCP (Model Context Protocol) sunucusu olarak da çalışabilir.
Mac için başka bir dikte uygulaması olan YapToText’i ben geliştiriyorum, bu yüzden superwhisper hakkında yazdıklarımı bunu bilerek okuyun. Buradaki superwhisper bilgilerinin hepsi kendi belgelerinden geliyor ve 10 Ekim 2026’da okundu. Sayfa şudur: CLI and MCP server.
Ücretsiz indirilir. Hesap gerekmez, kilitli özellik yoktur. Apple çipli bir Mac ve macOS 14 veya sonrası gerekir. Kaynak kodu GitHub’da.
Bu rehberin diğer dilleri: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Українська, Tiếng Việt, 简体中文, 繁體中文
Kurun
curl -fsSL https://superwhisper.com/install-cli.sh | bashNe olur: Betik, en son sürümü /usr/local/bin klasörüne, yazılamıyorsa ~/.local/bin klasörüne kurar.
Kurulumdan sonra kabuğunuz superwhisper’ı bulamazsa ~/.local/bin klasörünü PATH’inize ekleyin. Belgeler, ikili dosyaların ve sağlama toplamlarının GitHub’daki superultrainc/superwhisper-cli-release deposunda yayımlandığını söyler, böylece kurulum betiğini çalıştırmadan önce okuyabilirsiniz. CLI yalnızca macOS içindir.
Geçmişinizi okuyan komutlar
superwhisper’ın belgelerindeki CLI and MCP server sayfasından, 10 Ekim 2026’da okundu. Bunlar uygulamayla aynı yerel veritabanını okur ve cihazınızda çalışır.
| Komut | Ne yapar |
|---|---|
| search | Tüm yazıya dökmelerde tam metin araması yapar. AND, OR, NOT, tırnaklı ifadeleri ve önek yıldızını destekler |
| history | Son yazıya dökmeleri listeler. --mode, --since ve --before ile süzülür |
| read | Bir yazıya dökmeyi okur, kimlik vermezseniz en sonuncuyu. --raw, yapay zekâ işlemesinden önceki metni gösterir |
| stats | Yazıya dökme istatistikleri |
| modes | Kayıtlarınızda kullanılan modları sayılarıyla listeler |
| export | Her şeyi en eskiden başlayarak jsonl veya markdown olarak dışa aktarır |
| vocab | Sözlük terimlerini listeler, ekler veya kaldırır |
| snippets | Değiştirmeleri listeler, ayarlar veya kaldırır, Settings, Vocabulary içindeki From ve To çiftleriyle aynıdır |
| doctor | Hata raporları için veritabanı hakkında tanılama bilgisi |
| completions | Kabuk tamamlamalarını üretir |
Uygulamayı denetleyen komutlar
Aynı sayfadan. Bunlar çalışan uygulamaya bir istek gönderir, bu yüzden superwhisper açık olmalıdır.
| Komut | Ne yapar |
|---|---|
| record | Kaydı açıp kapatır |
| start | Kaydı başlatır. Zaten kayıttaysa hiçbir şey yapmaz |
| stop | Kaydı durdurur. Kayıtta değilse hiçbir şey yapmaz |
| switch | Etkin modu adına veya anahtarına göre değiştirir. Argüman verilmezse modlarınızı listeler |
| settings | Ayarlar penceresini açar |
| transcribe | Yazıya dökülmesi için uygulamaya bir ses dosyası gönderir. Dosyayı yazıya dökme Pro ister |
start, stop ve switch, superwhisper’ı bir kabuk komutu çalıştırabilen her şeyden betiklenebilir kılar. Buna bir başlatıcı, bir klavye yeniden eşleyici ya da yardımcı bir anahtar arayüzündeki bir düğme dahildir.
Örnekler
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.m4aNe olur: Her satır belgelerin kendi örneklerinden biridir. Çoğu komut, bir betiğin okuyabileceği çıktı için --json seçeneğini de kabul eder.
MCP sunucusu
superwhisper mcpNe olur: CLI, stdio üzerinden MCP konuşur ve arama, geçmiş, kayıtları okuma, modlar, istatistikler, sözlük ve snippets için araçlar sunar.
Belgelerden bir gizlilik notu: CLI’nin kendisi tamamen cihazınızda çalışır, ama MCP üzerinden bir yapay zekâ asistanı bağlandığında sorguladığı dökümler o asistana gönderilir ve onun kendi model ve veri ayarlarına göre işlenir. Gerisini superwhisper gizlilik sayfası anlatır.
YapToText ve komut satırı
YapToText’in bir komut satırı aracı ve MCP sunucusu yoktur. Tek tuşlu bir menü çubuğu uygulamasıdır. History sayfası tüm listeyi düz metin veya Markdown olarak dışa aktarır, bu da dışa aktarma ihtiyacını Terminal olmadan karşılar.
Satın alınacak bir şey olmadan Terminal’den yazıya dökmek için, YapToText’in üzerine kurulduğu motor whisper.cpp’dir. Komutlar yerel Whisper rehberinde, başka bir uygulamanın dosyalar ve klasörler için aracı ise MacWhisper CLI sayfasında yer alır.
Ücretsiz indirilir. Hesap gerekmez, kilitli özellik yoktur. Apple çipli bir Mac ve macOS 14 veya sonrası gerekir. Kaynak kodu GitHub’da.
Kısa özet
- Kurulum. Tek bir curl satırı, yalnızca macOS.
- Okuma. search, history, read, stats ve export.
- Denetim. record, start, stop, switch ve transcribe, uygulama açıkken.
- MCP. superwhisper mcp, stdio üzerinden.
- Gizlilik. Bir asistan MCP üzerinden dökümleri okuyana kadar yerel.
superwhisper komut ekler veya yeniden adlandırırsa GitHub’da bir issue açın, ben de bu sayfayı güncellerim. Hepsini okuyorum.
Ücretsiz indirilir. Hesap gerekmez, kilitli özellik yoktur. Apple çipli bir Mac ve macOS 14 veya sonrası gerekir. Kaynak kodu GitHub’da.
Rehberler
Diğer rehberler, İngilizce
Kaynaklar
- https://superwhisper.com/docs/get-started/cli (kontrol tarihi 10.10.2026)
- https://superwhisper.com/docs/get-started/history (kontrol tarihi 10.10.2026)
- https://github.com/ryleighnewman/YapToText (kontrol tarihi 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (kontrol tarihi 10.10.2026)
Sorular
superwhisper’ın CLI’si var mı?
Evet, macOS’ta. superwhisper komutu geçmişinizi arar ve dışa aktarır, sözlüğü düzenler ve çalışan uygulamayı denetler.
superwhisper CLI nasıl kurulur?
Belgelerindeki kurulum betiğini curl ile çalıştırın. Betik /usr/local/bin klasörüne, yazılamıyorsa ~/.local/bin klasörüne kurar.
Terminal’den bir superwhisper kaydı başlatabilir miyim?
Evet. superwhisper start, stop ve record kaydı denetler, uygulama açık olduğu sürece.
superwhisper’ın MCP sunucusu var mı?
Evet. superwhisper mcp, CLI’yi stdio üzerinden bir MCP sunucusu olarak çalıştırır ve arama, geçmiş, sözlük ve snippets için araçlar sunar.
superwhisper CLI Windows’ta çalışır mı?
Hayır. Belgeleri CLI’nin yalnızca macOS’ta bulunduğunu söyler.