Terminal-mac
lastmod 2026-11-13created 2026-11-131 edits
터미널에서 보고 조작하는 컴퓨터 사용 에이전트용 별도 macOS 데스크톱
About
- Apple Virtualization으로 실제 macOS 게스트를 띄우고, 게스트 안의 helper가 화면을 캡처하고 입력 이벤트를 보내는 구조. 터미널 뷰어가 Kitty/iTerm2 그래픽 프로토콜로 그 화면을 스트리밍함
- 게스트는 자체 앱·파일·계정·권한을 가진 별도 Mac. 호스트의 실행 중인 앱이나 로그인 세션을 물려받지 않고, 에이전트 명령이 실제 Mac의 포인터나 클립보드를 건드리지 않음
- 에이전트마다 가상 Mac을 한 대씩 주고 작업시킬 수 있음.
terminal-mac up work처럼 이름을 붙여 VM을 여러 대 만들 수 있음 - MCP 도구(screenshot, click, drag, scroll, type, key, status)와 observe → act → verify 루프를 알려주는 스킬 제공. Claude Code는
/plugin install terminal-mac --marketplace govijr/terminal-mac로 MCP 서버와 스킬을 한 번에 설치. Cursor, VS Code, Codex 등 다른 MCP 클라이언트도 지원 - 설치는
curl -fsSLhttps://github.com/govijr/terminal-mac/releases/latest/download/get.sh| bash. 첫 실행 때 Apple에서 macOS 복원 이미지를 받아 가상 Mac을 설치하고 부팅함 - 처음 한 번은 게스트에서 macOS 설정과 계정 생성을 마치고, TerminalMacGuest.app에 화면 기록·손쉬운 사용 권한을 줘야 함. 호스트에는 권한이 필요 없음
- 게스트 helper는 화면이 바뀔 때만 최대 30fps로 lz4 압축 프레임을 보내고, Kitty·Ghostty는 공유 메모리로 받음. 뷰어에서 Ctrl+G로 Mac 단축키 팔레트를 열고 Ctrl+]로 빠져나옴 (VM은 계속 실행)
- Apple Silicon, macOS 14 이상. 인라인 뷰어는 Ghostty, Kitty, iTerm2 지원. 자체 서명한 초기 릴리스 후보 단계. MIT 라이선스