superwhisper CLI: 설치법, 모든 명령, MCP 서버

글쓴이 · 게시일

superwhisper에는 Mac용 명령줄 도구가 있고, 이름도 superwhisper입니다. 로컬 받아쓰기 기록을 검색하고 내보내며, 단어장과 치환을 고치고, 실행 중인 앱을 제어합니다. 시작, 중지, 모드 전환, 파일 받아쓰기가 가능합니다. MCP(Model Context Protocol) 서버로도 실행할 수 있어서, AI 어시스턴트가 받아쓴 글을 검색하고 읽게 할 수 있습니다.

저는 Mac용 다른 받아쓰기 앱인 YapToText를 만들고 있으니, superwhisper에 관한 제 설명은 그 점을 감안하고 읽어 주세요. 여기에 적은 superwhisper의 사실은 모두 2026년 10월 10일에 읽은 superwhisper 문서에서 가져왔습니다. 해당 페이지는 CLI and MCP server입니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 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에 설치합니다.

설치 뒤에 셸이 superwhisper를 찾지 못하면 ~/.local/bin을 PATH에 추가하세요. 문서에 따르면 실행 파일과 체크섬은 GitHub의 superultrainc/superwhisper-cli-release 저장소에 공개되어 있어서, 설치 스크립트를 실행하기 전에 읽어 볼 수 있습니다. CLI는 macOS 전용입니다.

기록을 읽는 명령

superwhisper 문서의 CLI and MCP server 페이지에서 2026년 10월 10일에 읽은 내용입니다. 이 명령들은 앱과 같은 로컬 데이터베이스를 읽으며 기기에서 실행됩니다.

명령하는 일
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셸 자동 완성을 생성합니다

앱을 제어하는 명령

같은 페이지의 내용입니다. 이 명령들은 실행 중인 앱에 요청을 보내므로 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가 stdio로 MCP를 사용하고, 검색, 기록, 녹음 읽기, 모드, 통계, 단어장, 스니펫을 위한 도구를 제공합니다.

문서에서 개인정보와 관련해 짚을 점이 하나 있습니다. CLI 자체는 전부 기기에서 실행되지만, MCP로 AI 어시스턴트를 연결하면 그 어시스턴트가 조회한 받아쓴 글이 어시스턴트로 전송되고, 그 어시스턴트의 모델과 데이터 설정에 따라 처리됩니다. 나머지는 superwhisper 개인정보 보호 페이지에서 다룹니다.

YapToText와 명령줄

YapToText에는 명령줄 도구도 MCP 서버도 없습니다. 키 하나로 쓰는 메뉴 막대 앱입니다. History 페이지에서 전체 목록을 일반 텍스트나 Markdown으로 내보낼 수 있어서, 내보내기가 필요하면 터미널 없이도 됩니다.

돈을 내지 않고 터미널에서 받아쓰려면 whisper.cpp가 있습니다. YapToText가 바탕으로 삼은 엔진입니다. 명령은 로컬 Whisper 가이드에 있고, 파일과 폴더를 위한 다른 앱의 도구는 MacWhisper CLI 페이지에서 다룹니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

요약

  • 설치. curl 한 줄이고, macOS 전용입니다.
  • 읽기. search, history, read, stats, export입니다.
  • 제어. record, start, stop, switch, transcribe이며, 앱이 열려 있어야 합니다.
  • MCP. stdio로 쓰는 superwhisper mcp입니다.
  • 개인정보. 어시스턴트가 MCP로 받아쓴 글을 읽기 전까지는 로컬입니다.

superwhisper가 명령을 추가하거나 이름을 바꾸면 GitHub에 이슈를 남겨 주세요. 이 페이지를 고치겠습니다. 모두 읽습니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

글쓴이 소개. Ryleigh Newman은 소프트웨어를 개발합니다. 손으로 타이핑하기가 어려워서, 이 사이트에서 소개하는 앱인 YapToText로 매일 받아쓰기를 합니다. 이 페이지는 영어에서 번역한 것입니다. 앱의 화면과 사이트의 다른 페이지는 영어로 되어 있습니다. 프로젝트 더 알아보기(영어).

가이드

다른 가이드(영어)

출처

자주 묻는 질문

superwhisper에 CLI가 있나요?

네, macOS에서 쓸 수 있습니다. superwhisper 명령으로 기록을 검색하고 내보내며, 단어장을 고치고, 실행 중인 앱을 제어합니다.

superwhisper CLI는 어떻게 설치하나요?

문서에 있는 설치 스크립트를 curl로 실행합니다. /usr/local/bin에 설치하고, 쓸 수 없으면 ~/.local/bin에 설치합니다.

터미널에서 superwhisper 녹음을 시작할 수 있나요?

네. superwhisper start, stop, record로 녹음을 제어할 수 있고, 앱이 열려 있어야 합니다.

superwhisper에 MCP 서버가 있나요?

네. superwhisper mcp는 CLI를 stdio로 쓰는 MCP 서버로 실행하며, 검색, 기록, 단어장, 스니펫을 위한 도구를 제공합니다.

superwhisper CLI는 Windows에서 되나요?

아니요. 문서에 따르면 CLI는 macOS에서만 쓸 수 있습니다.