CLI của superwhisper: cách cài đặt, mọi lệnh và máy chủ MCP

Bài viết: · Đăng ngày

superwhisper có một công cụ dòng lệnh cho máy Mac, cũng tên là superwhisper. Nó tìm kiếm và xuất lịch sử đọc chính tả lưu trên máy, sửa từ vựng và phần thay thế, và điều khiển ứng dụng đang chạy: bắt đầu, dừng, đổi chế độ, chép lời một tệp. Nó cũng có thể chạy như một máy chủ MCP (Model Context Protocol), cho phép một trợ lý AI tìm và đọc các bản đọc chính tả của bạn.

Tôi phát triển YapToText, một ứng dụng đọc chính tả khác cho máy Mac, nên hãy đọc những gì tôi viết về superwhisper với điều đó trong đầu. Mọi thông tin về superwhisper ở đây lấy từ tài liệu của chính hãng, đọc vào ngày 10 tháng 10 năm 2026. Trang đó là CLI and MCP server.

Tải YapToText trên Mac App StoreTải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.

Hướng dẫn này bằng ngôn ngữ khác: 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, Українська, 简体中文, 繁體中文

Trong trang này: 11 phần
  1. Cài đặt
  2. Các lệnh đọc lịch sử của bạn
  3. Các lệnh điều khiển ứng dụng
  4. Ví dụ
  5. Máy chủ MCP
  6. YapToText và dòng lệnh
  7. Tóm tắt ngắn
  8. Hướng dẫn
  9. Hướng dẫn khác, bằng tiếng Anh
  10. Nguồn
  11. Câu hỏi

Cài đặt

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

Điều xảy ra: Tập lệnh cài bản phát hành mới nhất vào /usr/local/bin, hoặc vào ~/.local/bin nếu thư mục đầu không ghi được.

Nếu sau đó shell không tìm thấy superwhisper, hãy thêm ~/.local/bin vào PATH của bạn. Tài liệu cho biết các tệp nhị phân và checksum được đăng trong kho superultrainc/superwhisper-cli-release trên GitHub, nên bạn có thể đọc tập lệnh cài đặt trước khi chạy. CLI chỉ dành cho macOS.

Các lệnh đọc lịch sử của bạn

Theo trang tài liệu CLI and MCP server của superwhisper, đọc ngày 10 tháng 10 năm 2026. Các lệnh này đọc cùng cơ sở dữ liệu cục bộ với ứng dụng và chạy trên thiết bị của bạn.

LệnhViệc thực hiện
searchTìm toàn văn trong mọi bản chép lời. Hỗ trợ AND, OR, NOT, cụm từ trong ngoặc kép và dấu sao ở cuối để khớp tiền tố
historyLiệt kê các bản chép lời gần đây. Lọc bằng --mode, --since và --before
readĐọc một bản chép lời, là bản mới nhất nếu bạn không đưa ID. --raw hiện văn bản trước khi xử lý bằng AI
statsThống kê về các bản chép lời
modesLiệt kê các chế độ đã dùng trong bản ghi âm của bạn, kèm số lần
exportXuất toàn bộ, cũ nhất trước, dạng jsonl hoặc markdown
vocabLiệt kê, thêm hoặc xóa các từ trong từ vựng
snippetsLiệt kê, đặt hoặc xóa các phần thay thế, tức các cặp From và To giống như trong Settings, Vocabulary
doctorThông tin chẩn đoán về cơ sở dữ liệu, dùng cho báo cáo lỗi
completionsTạo tính năng tự hoàn thành cho shell

Các lệnh điều khiển ứng dụng

Cũng từ trang đó. Các lệnh này gửi yêu cầu đến ứng dụng đang chạy, nên superwhisper phải đang mở.

LệnhViệc thực hiện
recordBật hoặc tắt việc ghi âm
startBắt đầu ghi âm. Không làm gì nếu đang ghi âm
stopDừng ghi âm. Không làm gì nếu không đang ghi âm
switchĐổi chế độ đang dùng theo tên hoặc khóa. Không có đối số thì liệt kê các chế độ của bạn
settingsMở cửa sổ cài đặt
transcribeGửi một tệp âm thanh đến ứng dụng để chép lời. Chép lời tệp cần Pro

start, stop và switch giúp superwhisper có thể chạy bằng tập lệnh từ bất cứ thứ gì chạy được một lệnh shell. Đó có thể là một trình khởi chạy, một công cụ đổi phím, hoặc một nút trên giao diện công tắc hỗ trợ.

Ví dụ

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

Điều xảy ra: Mỗi dòng là một ví dụ lấy từ chính tài liệu. Hầu hết các lệnh cũng nhận --json để cho ra kết quả mà tập lệnh đọc được.

Máy chủ MCP

superwhisper mcp

Điều xảy ra: CLI nói chuyện MCP qua stdio và cung cấp các công cụ để tìm kiếm, xem lịch sử, đọc bản ghi âm, chế độ, thống kê, từ vựng và snippets.

Một điểm về quyền riêng tư từ tài liệu: bản thân CLI chạy hoàn toàn trên thiết bị của bạn, nhưng khi một trợ lý AI được kết nối qua MCP, các bản chép lời mà nó truy vấn sẽ được gửi đến trợ lý đó và xử lý theo mô hình cùng cài đặt dữ liệu của chính nó. Trang quyền riêng tư của superwhisper nói phần còn lại.

YapToText và dòng lệnh

YapToText không có công cụ dòng lệnh và không có máy chủ MCP. Nó là một ứng dụng trên thanh menu chỉ dùng một phím. Trang History của nó xuất toàn bộ danh sách dạng văn bản thuần hoặc Markdown, đáp ứng nhu cầu xuất mà không cần Terminal.

Để chép lời từ Terminal mà không phải mua gì, whisper.cpp là bộ máy mà YapToText được xây dựng trên đó. Hướng dẫn Whisper cục bộ có các lệnh, còn trang CLI của MacWhisper nói về công cụ của một ứng dụng khác cho tệp và thư mục.

Tải YapToText trên Mac App StoreTải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.

Tóm tắt ngắn

  • Cài đặt. Một dòng curl, chỉ macOS.
  • Đọc. search, history, read, stats và export.
  • Điều khiển. record, start, stop, switch và transcribe, khi ứng dụng đang mở.
  • MCP. superwhisper mcp, qua stdio.
  • Quyền riêng tư. Cục bộ, cho đến khi một trợ lý đọc bản chép lời qua MCP.

Nếu superwhisper thêm hoặc đổi tên lệnh, hãy mở một issue trên GitHub và tôi sẽ cập nhật trang này. Tôi đọc tất cả.

Tải YapToText trên Mac App StoreTải về miễn phí. Không cần tài khoản, không có tính năng bị khóa, dành cho macOS 14 trở lên trên máy Mac có chip Apple. Mã nguồn trên GitHub.

Về người viết. Ryleigh Newman phát triển phần mềm, gặp khó khăn khi gõ phím và mỗi ngày đều đọc chính tả bằng YapToText, ứng dụng mà trang web này giới thiệu. Trang này được dịch từ tiếng Anh. Giao diện ứng dụng và các trang còn lại của trang web bằng tiếng Anh. Tìm hiểu thêm về dự án, bằng tiếng Anh.

Hướng dẫn

Hướng dẫn khác, bằng tiếng Anh

Nguồn

Câu hỏi

superwhisper có CLI không?

Có, trên macOS. Lệnh superwhisper tìm kiếm và xuất lịch sử của bạn, sửa từ vựng và điều khiển ứng dụng đang chạy.

Làm sao cài CLI của superwhisper?

Chạy tập lệnh cài đặt trong tài liệu của hãng bằng curl. Nó cài vào /usr/local/bin, hoặc vào ~/.local/bin nếu thư mục đầu không ghi được.

Có bắt đầu ghi âm superwhisper từ Terminal được không?

Được. superwhisper start, stop và record điều khiển việc ghi âm, miễn là ứng dụng đang mở.

superwhisper có máy chủ MCP không?

Có. superwhisper mcp chạy CLI như một máy chủ MCP qua stdio, với các công cụ cho tìm kiếm, lịch sử, từ vựng và snippets.

CLI của superwhisper có chạy trên Windows không?

Không. Tài liệu của hãng cho biết CLI chỉ có trên macOS.