Repolode
제출하기
govijr

govijr/terminal-mac

AI 에이전트가 MCP 도구로 제어하고 Kitty, Ghostty 또는 iTerm2 그래픽을 통해 터미널에서 볼 수 있는 macOS 가상 머신입니다.

GitHub에서 보기
스타
2,111
포크
132
열린 이슈
1
마지막 커밋
어제

어떤 프로젝트인가요?

terminal-mac은 Apple의 Virtualization framework를 사용해 Apple silicon에서 실제 macOS 게스트를 실행합니다. 게스트 내부의 도우미 앱이 게스트 화면을 캡처하고 키보드 및 마우스 이벤트를 전달하므로, 에이전트가 물리 Mac의 포인터를 움직이거나 클립보드를 건드리지 않고 별도의 Mac을 조작할 수 있습니다. 게스트에는 자체 앱, 파일, 계정이 있으며 호스트의 로그인 세션을 이어받지 않습니다.

터미널 뷰어는 Kitty, Ghostty 또는 iTerm2 그래픽으로 게스트 화면을 인라인 스트리밍하며, 입력, 클릭, 드래그, 스크롤과 다양한 Mac 단축키를 지원합니다. 에이전트 명령은 MCP 도구(screenshot, click, drag, scroll, type, key, status)로 제공되며, 관찰-동작-확인 루프를 설명하는 skill도 함께 제공됩니다. CLI는 복원 이미지 다운로드, VM 생성과 부팅, 일시 정지, 재개, 중지 등의 수명 주기 명령을 처리합니다.

이 프로젝트는 아직 초기 릴리스 후보 단계입니다. 최초 설정 중 게스트의 Screen Recording 및 Accessibility 권한을 직접 허용해야 하며, VM은 기본적으로 네트워크와 격리되지 않습니다.

핵심 기능

  • 01Apple silicon에서 자체 앱, 파일, 계정을 갖춘 실제 macOS 게스트를 실행합니다.
  • 02Kitty, Ghostty 또는 iTerm2 터미널에 게스트 화면을 인라인으로 스트리밍합니다.
  • 03screenshot, click, drag, scroll, type, key, status를 MCP 도구로 제공합니다.
  • 04에이전트 입력으로 호스트의 포인터가 움직이거나 클립보드가 변경되지 않습니다.
  • 05curl 스크립트로 설치하며 첫 실행 시 macOS 복원 이미지를 다운로드합니다.
  • 06터미널에서 직접 전송할 수 없는 키를 위한 Mac 단축키 팔레트를 Ctrl+G로 제공합니다.

활용 사례

  • 자신의 데스크톱을 넘겨주지 않고 AI 에이전트가 macOS 전용 앱을 조작하게 할 때.
  • 격리된 가상 Mac에서 macOS GUI 소프트웨어를 테스트할 때.
  • SSH 없이 로컬 세션에서 터미널로 가상 Mac을 보거나 조작할 때.
  • 폐기 가능한 macOS 환경이 필요한 컴퓨터 사용 에이전트 실험을 실행할 때.

빠른 시작

  1. 1

    README의 curl 설치 프로그램으로 설치합니다(SHA-256 검증 포함).

  2. 2

    안내에 따라 설정을 진행해 가상 Mac을 다운로드하고 설치한 후 부팅합니다.

    terminal-mac up
  3. 3

    MCP를 통해 AI 에이전트를 연결합니다.

    claude mcp add terminal-mac -- terminal-mac mcp

사용 전 알아둘 점

  • macOS 14 이상을 실행하는 Apple silicon Mac이 필요합니다.
  • 초기 릴리스 후보 버전이며, 깨끗한 Mac에서 게스트를 대상으로 한 실제 테스트는 아직 진행되지 않았습니다.
  • 릴리스는 자체 서명되었으며 Apple의 공증을 받지 않았습니다.
  • 인라인 뷰어는 Ghostty, Kitty 또는 iTerm2에서만 작동합니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱MCP 서버CLI·터미널 도구오픈소스 Mac 앱

토픽

#macos#virtualization#computer-use#mcp#ai-agent#terminal#swift#apple-silicon

자주 묻는 질문

terminal-mac은(는) 무엇인가요?
AI 에이전트가 MCP 도구로 제어하고 Kitty, Ghostty 또는 iTerm2 그래픽을 통해 터미널에서 볼 수 있는 macOS 가상 머신입니다. terminal-mac은 Apple의 Virtualization framework를 사용해 Apple silicon에서 실제 macOS 게스트를 실행합니다. 게스트 내부의 도우미 앱이 게스트 화면을 캡처하고 키보드 및 마우스 이벤트를 전달하므로, 에이전트가 물리 Mac의 포인터를 움직이거나 클립보드를 건드리지 않고 별도의 Mac을 조작할 수 있습니다. 게스트에는 자체 앱, 파일, 계정이 있으며 호스트의 로그인 세션을 이어받지 않습니다.
terminal-mac은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
terminal-mac은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
terminal-mac은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. terminal-mac의 마지막 커밋은 2026년 11월 6일입니다.
terminal-mac은(는) 어디에 사용할 수 있나요?
자신의 데스크톱을 넘겨주지 않고 AI 에이전트가 macOS 전용 앱을 조작하게 할 때. 격리된 가상 Mac에서 macOS GUI 소프트웨어를 테스트할 때. SSH 없이 로컬 세션에서 터미널로 가상 Mac을 보거나 조작할 때. 폐기 가능한 macOS 환경이 필요한 컴퓨터 사용 에이전트 실험을 실행할 때.
terminal-mac는 어떻게 설치하나요?
README의 curl 설치 프로그램으로 설치합니다(SHA-256 검증 포함). 안내에 따라 설정을 진행해 가상 Mac을 다운로드하고 설치한 후 부팅합니다.: terminal-mac up MCP를 통해 AI 에이전트를 연결합니다.: claude mcp add terminal-mac -- terminal-mac mcp
terminal-mac은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/govijr/terminal-mac

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트