superwhisper CLI：怎麼安裝，每一個指令，以及 MCP 伺服器

作者 · 發佈於

superwhisper 有一個 Mac 用的命令列工具，名字同樣叫 superwhisper。它可以搜尋和輸出你本機的聽寫歷史，編輯詞彙和取代，也能控制正在執行的 App：開始、停止、切換模式、轉錄檔案。它還可以當成 MCP（Model Context Protocol）伺服器執行，讓 AI 助理搜尋和讀取你的聽寫內容。

我做的是另一款 Mac 聽寫 App，叫 YapToText，所以請在閱讀我對 superwhisper 的說法時記得這一點。這裡關於 superwhisper 的每一項內容，都來自它自己的說明文件，我在 2026年10月10日讀過。讀的頁面是 CLI and MCP server。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

用其他語言閱讀： English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文

安裝

curl -fsSL https://superwhisper.com/install-cli.sh | bash

執行結果：這個指令稿會把最新版本安裝到 /usr/local/bin，如果那裡不能寫入，就安裝到 ~/.local/bin。

如果安裝之後你的 shell 找不到 superwhisper，請把 ~/.local/bin 加進 PATH。說明文件寫道，執行檔和校驗碼發佈在 GitHub 的 superultrainc/superwhisper-cli-release 儲存庫，所以你可以在執行之前先讀過安裝指令稿。這個 CLI 只支援 macOS。

讀取歷史記錄的指令

來自 superwhisper 說明文件的 CLI and MCP server 頁面，2026年10月10日查閱。這些指令讀的是和 App 相同的本機資料庫，在你的裝置上執行。

指令作用
search在所有轉錄文字中做全文搜尋。支援 AND、OR、NOT、加引號的片語，以及結尾的萬用星號
history列出最近的轉錄。可以用 --mode、--since 和 --before 篩選
read讀取一筆轉錄，沒有指定 ID 時讀最新的一筆。--raw 會顯示 AI 處理之前的文字
stats轉錄的統計資料
modes列出你的錄音用過的模式，附上次數
export由舊到新輸出全部內容，格式為 jsonl 或 markdown
vocab列出、新增或移除詞彙
snippets列出、設定或移除取代，就是 Settings，Vocabulary 裡同樣的 From 和 To 配對
doctor資料庫的診斷資訊，用於回報錯誤
completions產生 shell 的自動補全

控制 App 的指令

來自同一個頁面。這些指令會向正在執行的 App 送出請求，所以 superwhisper 必須是開啟的。

指令作用
record切換錄音的開和關
start開始錄音。已經在錄音時什麼都不做
stop停止錄音。沒有在錄音時什麼都不做
switch依名稱或按鍵切換目前的模式。沒有帶參數時，列出你的模式
settings打開設定視窗
transcribe把音訊檔案交給 App 轉錄。檔案轉錄需要 Pro

有了 start、stop 和 switch，任何能執行 shell 指令的東西都可以用指令稿控制 superwhisper。包括啟動器、鍵盤重新對應工具，或輔助開關介面上的一個按鈕。

範例

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

執行結果：每一行都是說明文件自己的範例。大多數指令也接受 --json，輸出可以讓指令稿讀取。

MCP 伺服器

superwhisper mcp

執行結果：這個 CLI 透過 stdio 使用 MCP，並提供搜尋、歷史記錄、讀取錄音、模式、統計、詞彙和取代的工具。

說明文件有一點和隱私有關：CLI 本身完全在你的裝置上執行，但當 AI 助理透過 MCP 連線時，它查詢的逐字稿會被送到那個助理，並依照它自己的模型和資料設定來處理。superwhisper 隱私頁面說明了其餘的部分。

YapToText 和命令列

YapToText 沒有命令列工具，也沒有 MCP 伺服器。它是一個選單列 App，只用一個鍵。它的 History 頁面可以把整份清單輸出成純文字或 Markdown，不用終端機就能滿足輸出的需求。

想在終端機做轉錄，又不想花錢，whisper.cpp 就是 YapToText 所用的引擎。本機 Whisper 指南有指令，MacWhisper CLI 頁面則介紹另一個 App 處理檔案和資料夾的工具。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

重點整理

  • 安裝。一行 curl，只支援 macOS。
  • 讀取。search、history、read、stats 和 export。
  • 控制。record、start、stop、switch 和 transcribe，要開著 App。
  • MCP。superwhisper mcp，透過 stdio。
  • 隱私。在本機，直到有助理透過 MCP 讀取逐字稿。

如果 superwhisper 新增或更改了指令名稱，請在 GitHub 上提交 issue，我會更新這一頁。每一則我都會看。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

關於作者。 Ryleigh Newman 從事軟體開發，用手打字有困難，每天都用本站介紹的 YapToText 聽寫。本頁譯自英文。App 的介面和網站的其他頁面是英文的。 進一步瞭解這個專案（英文）。

指南

更多指南（英文）

資料來源

常見問題

superwhisper 有 CLI 嗎？

有，在 macOS 上。superwhisper 指令可以搜尋和輸出你的歷史記錄、編輯詞彙，並控制正在執行的 App。

怎麼安裝 superwhisper CLI？

用 curl 執行它說明文件裡的安裝指令稿。它會安裝到 /usr/local/bin，如果那裡不能寫入，就安裝到 ~/.local/bin。

可以從終端機開始 superwhisper 的錄音嗎？

可以。superwhisper start、stop 和 record 可以控制錄音，只要 App 是開啟的。

superwhisper 有 MCP 伺服器嗎？

有。superwhisper mcp 會透過 stdio 把 CLI 當成 MCP 伺服器執行，提供搜尋、歷史記錄、詞彙和取代的工具。

superwhisper CLI 可以在 Windows 上用嗎？

不行。它的說明文件寫道，CLI 只支援 macOS。