CLI superwhisper: как установить, все команды и сервер MCP

Текст: · Опубликовано

У superwhisper есть инструмент командной строки для Mac, который тоже называется superwhisper. Он ищет по локальной истории диктовок и экспортирует её, правит словарь и замены и управляет запущенным приложением: начинает и останавливает запись, переключает режим, расшифровывает файл. Он может работать и как сервер MCP (Model Context Protocol), который позволяет ИИ-ассистенту искать в ваших диктовках и читать их.

Я разрабатываю YapToText, другое приложение для диктовки на Mac, поэтому читайте то, что я пишу о superwhisper, с учётом этого. Все сведения о superwhisper здесь взяты из его собственной документации, прочитанной 10 октября 2026 года. Это страница CLI and MCP server.

Загрузить YapToText в Mac App StoreБесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на 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.

Если после этого оболочка не находит superwhisper, добавьте ~/.local/bin в PATH. В документации сказано, что бинарные файлы и контрольные суммы публикуются в репозитории superultrainc/superwhisper-cli-release на GitHub, так что скрипт установки можно прочитать до запуска. CLI работает только в macOS.

Команды, которые читают историю

Со страницы документации superwhisper CLI and MCP server, прочитанной 10 октября 2026 года. Эти команды читают ту же локальную базу данных, что и приложение, и работают на вашем устройстве.

КомандаЧто делает
searchПолнотекстовый поиск по всем расшифровкам. Поддерживает AND, OR, NOT, фразы в кавычках и звёздочку для префикса
historyВыводит список последних расшифровок. Фильтры: --mode, --since и --before
readЧитает одну расшифровку, последнюю, если не указать ID. --raw показывает текст до обработки ИИ
statsСтатистика расшифровок
modesВыводит режимы, использованные в ваших записях, с количеством
exportЭкспортирует всё, начиная с самых старых, в формате jsonl или markdown
vocabПоказывает, добавляет или удаляет термины словаря
snippetsПоказывает, задаёт или удаляет замены, те же пары From и To, что в Settings, Vocabulary
doctorДиагностическая информация о базе данных, для сообщений об ошибках
completionsСоздаёт автодополнения для оболочки

Команды, которые управляют приложением

С той же страницы. Эти команды отправляют запрос запущенному приложению, поэтому superwhisper должен быть открыт.

КомандаЧто делает
recordПереключает запись
startНачинает запись. Ничего не делает, если запись уже идёт
stopОстанавливает запись. Ничего не делает, если записи нет
switchПереключает активный режим по имени или ключу. Без аргумента выводит список ваших режимов
settingsОткрывает окно настроек
transcribeОтправляет аудиофайл приложению на расшифровку. Для расшифровки файлов нужен Pro

Команды start, stop и switch позволяют управлять 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 говорит по MCP через stdio и предоставляет инструменты для поиска, истории, чтения записей, режимов, статистики, словаря и замен.

Одно замечание о приватности из документации: сам CLI работает целиком на вашем устройстве, но когда ИИ-ассистент подключён по MCP, расшифровки, которые он запрашивает, отправляются этому ассистенту и обрабатываются по настройкам его модели и данных. Об остальном рассказывает страница о приватности superwhisper.

YapToText и командная строка

В YapToText нет инструмента командной строки и сервера MCP. Это приложение в строке меню с одной клавишей. Его страница History экспортирует весь список как простой текст или Markdown, что закрывает потребность в экспорте без Терминала.

Для расшифровки из Терминала без покупок есть whisper.cpp, движок, на котором построен YapToText. Команды собраны в руководстве по локальному Whisper, а страница о CLI MacWhisper рассказывает об инструменте другого приложения для файлов и папок.

Загрузить YapToText в Mac App StoreБесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.

Коротко

  • Установка. Одна строка с curl, только macOS.
  • Чтение. search, history, read, stats и export.
  • Управление. record, start, stop, switch и transcribe, при открытом приложении.
  • MCP. superwhisper mcp, через stdio.
  • Приватность. Всё локально, пока ассистент не читает расшифровки через MCP.

Если superwhisper добавит команды или переименует их, создайте issue на GitHub, и я обновлю эту страницу. Я читаю каждое.

Загрузить YapToText в Mac App StoreБесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.

Кто пишет. Ryleigh Newman разрабатывает программы, с трудом печатает на клавиатуре и каждый день диктует в YapToText, приложении, которому посвящён этот сайт. Эта страница переведена с английского. Интерфейс приложения и остальные страницы сайта на английском. Подробнее о проекте, на английском.

Руководства

Другие руководства, на английском

Источники

Вопросы

Есть ли у superwhisper CLI?

Да, в macOS. Команда superwhisper ищет по истории и экспортирует её, правит словарь и управляет запущенным приложением.

Как установить CLI superwhisper?

Запустите скрипт установки из его документации через curl. Он ставит программу в /usr/local/bin, а если туда писать нельзя, то в ~/.local/bin.

Можно ли начать запись superwhisper из Терминала?

Да. Команды superwhisper start, stop и record управляют записью, пока приложение открыто.

Есть ли у superwhisper сервер MCP?

Да. Команда superwhisper mcp запускает CLI как сервер MCP через stdio, с инструментами для поиска, истории, словаря и замен.

Работает ли CLI superwhisper в Windows?

Нет. В его документации сказано, что CLI есть только для macOS.