GitHub TrendingAI · 머신러닝

govijr/terminal-mac

터미널에서 macOS 가상머신 제어하기

원제 govijr/terminal-mac

스타 2,305Swift
Key Point

에이전트 기반 자동화·RPA 작업 시 호스트 시스템과 분리된 독립적인 컴퓨터 제어 환경이 필요한 개발자와 AI 애플리케이션 제작자에게 직접적인 기술 수단을 제공한다.

핵심 요약

  • Apple silicon Mac에서 실제 macOS를 게스트 VM으로 실행하고 터미널에서 화면을 스트리밍·제어하는 도구 terminal-mac의 초기 출시 버전이 공개됐다.
  • VM 내부 헬퍼 애플리케이션이 화면을 캡처해 Kitty·iTerm2·Ghostty의 그래픽 프로토콜로 스트리밍하며, lz4 압축 픽셀을 공유 메모리로 전달해 최대 30fps로 렌더링한다.
  • AI 에이전트용 MCP 서버를 제공해 screenshot·click·drag·scroll·type·key·status 도구로 게스트를 제어하며, Claude Code 플러그인이나 개별 MCP 클라이언트로 통합할 수 있다.
  • macOS 14 이상, Apple silicon Mac이 필요하며 초기 실행 시 Apple에서 macOS 이미지를 다운로드하고 기본 64GB 논리 용량의 VM 디스크가 필요하다.
  • 설치 후 게스트 VM에서 TerminalMacGuest.app을 열어 Screen Recording·Accessibility 권한을 부여하는 일회 설정이 필요하며, 호스트 환경의 개인정보나 실행 중인 앱을 상속하지 않는다.
  • 에이전트 명령어는 별도 헬퍼를 통해 호스트의 포인터나 클립보드에 영향 없이 게스트만 제어하고, VM 시작·설정·재사용은 배경 프로세스로 동작한다.
  • Swift로 작성됐으며 Xcode 16 이상이 필요하고, 자체 서명된 인증서로 배포되어 Apple 공증을 거치지 않았으며 GitHub 스폰서십으로 유지된다.
  • Retina 디스플레이용 2x HiDPI 기본 설정을 지원하고, 터미널 분할·tmux 통과·VM 복제·체크포인트·자동 게스트 설정 등은 향후 계획 중이다.
  • 격리 모델에서 게스트는 명시적인 2개 공유폴더(control·tools)만 접근하며 호스트 홈, 프로젝트, 클립보드, 카메라는 연결되지 않고, 원격 제어 네트워크 리스너도 없다.
  • 기본 NAT 네트워킹은 게스트 인터넷 접근을 허용하지만 hostile-code 환경으로 설계되지 않았으며, --offline 옵션으로 네트워크를 비활성화할 수 있다.
  • 메일박스 프로토콜로 요청·응답 JSON 및 스크린샷을 교환하고 메시지 크기 제한·요청 ID 검증·액션 만료를 구현하며, 호스트는 게스트 제공 콘텐츠를 실행하지 않는다.
  • 프로토콜 안전성·경계 방어·UTF-8 처리 등에 대한 자동화 테스트가 있으며, 실제 VM 설치·부팅·권한 부여 성공의 증거는 별도 검증 문서(docs/VALIDATION.md)에 기록된다.
AI 요약 안내

AI가 한국어로 정리한 내용입니다. 정확한 정보는 원문을 확인해 주세요.

요약 원칙 ↗