AgentDesk

아이폰에서 내 Mac 을 씁니다.
화면, 터미널, 파일까지.

Mac 에 에이전트를 한 줄로 설치하고 아이폰 앱과 페어링합니다. Tailscale 로 직접 붙고, 안 되면 릴레이로 돌아갑니다. 지금은 클로즈드 베타입니다.

클로즈드 베타 · 무료 · macOS 14 이상 · iPhone, iPad

AgentDesk 화면 탭. 아이폰에 Mac mini 의 바탕화면이 스트리밍되고 있다 — iPhone 에서 본 Mac mini 화면. 2026년 6월 실기 캡처.

화면만 보내는 원격 데스크톱이 아닙니다.

화면을 보면서 터미널과 파일은 따로 다룹니다. 글자를 스트리밍 영상으로 읽지 않아도 됩니다.

	화면만 보내는 방식	AgentDesk
화면	화면 스트리밍	ScreenCaptureKit 캡처, H264, 4K 상한 30fps, 적응형 비트레이트
터미널	화면 속 터미널 창을 조작	대화형 PTY (zsh, bash)를 별도 탭으로
파일	화면 속 Finder 를 조작	탐색, 삭제, 이동, 청크 스트리밍 업로드와 다운로드
연결	제조사 릴레이	내 Tailscale 로 직접. 안 되면 WebSocket 릴레이로 폴백

실제 화면입니다.

AgentDesk 터미널 탭. macmini@wevesolutions 프롬프트에서 ls 출력 — 터미널은 화면이 아니라 텍스트로 옵니다.Mac 의 zsh 가 PTY 로 열립니다. 명령을 보내고 출력을 텍스트로 받습니다. 화면 스트리밍보다 가볍고 글자가 또렷합니다.

AgentDesk 파일 탭. Mac 폴더 목록 — 파일은 탐색기에서 바로 옮깁니다.Mac 의 폴더를 열어 파일을 내려받거나 올립니다. 큰 파일은 청크로 나눠 보내고 진행률이 보입니다.

AgentDesk 조이스틱 제어 화면 — 마우스는 조이스틱으로 움직입니다.이동, 클릭, 스크롤, 드래그를 CGEvent 로 보냅니다. 핀치로 확대하고 팬으로 이동합니다.

설치는 한 줄입니다.

접속 대상 Mac 에서 아래 한 줄을 실행합니다. 공증된 앱을 받아 /Applications 에 넣고 실행합니다. zip 으로 직접 받기도 됩니다.

Mac 터미널

curl -fsSL https://www.wevesolutions.co.kr/downloads/agentdesk/install.sh | bash

스크립트가 찍는 안내 (원문)

▶ AgentDesk 에이전트 다운로드…
▶ 압축 해제…
▶ 설치: /Applications/AgentDeskAgent.app
▶ 실행…

✅ 설치 완료: /Applications/AgentDeskAgent.app
   메뉴바 아이콘 → 시작 → 아이폰 AgentDesk 앱으로 페어링.
   첫 '시작' 시 화면 기록 권한을 허용하세요.

프레임은 인증된 한 사람에게만 갑니다.

	언제	어떻게
Tailscale 직결	iPhone 과 Mac 이 같은 tailnet 에 있을 때. 기본 경로	WireGuard. 우리 서버를 거치지 않음
릴레이 폴백	직결이 안 될 때	WebSocket 바이트 터널. 방은 기기 지문
페어링	처음 한 번	HMAC 챌린지-응답, 계정에 SHA-256 지문으로 귀속, 딥링크 agentdesk://
미디어 티켓	화면을 받을 때마다	제어 채널 인증을 통과한 클라이언트만 단명 1회용 티켓으로 프레임 수신

아직 없는 것을 적어 둡니다.

멀티 모니터. 지금은 디스플레이 하나만 캡처합니다.
클립보드 이미지와 파일. 텍스트만 양방향으로 맞춥니다.
QR 카메라 스캔. 페어링 코드는 딥링크로 붙여 넣습니다.
Windows 호스트와 데스크톱 클라이언트. 호스트는 macOS, 클라이언트는 iPhone 과 iPad 입니다.
AI 에이전트. GUI 자동화와 MCP 연동은 v2.0 로드맵이고 지금 앱에는 없습니다.

가격

베타 기간에는 무료입니다. 정식 가격은 정해지지 않았습니다. 정해지면 이 페이지와 앱에 먼저 적습니다.

베타에 참여하려면

1
이메일
platform@wevesolutions.co.kr 로 사용할 Mac 과 iPhone 을 적어 보냅니다.
2
초대
검토 후 아이폰 앱 설치 방법을 안내합니다.
3
설치와 페어링
Mac 에 에이전트를 한 줄로 설치하고, 메뉴바에서 시작한 뒤 아이폰 앱으로 페어링합니다.

베타 참여 신청

사양

호스트	macOS 14 이상 (Apple Silicon, Intel). Developer ID 서명, Apple 공증. 에이전트 1.6 MB
클라이언트	iPhone, iPad (Swift 6, SwiftUI)
필요한 것	Tailscale. 첫 실행 때 화면 기록 권한
영상	ScreenCaptureKit → VideoToolbox H264 High. 네이티브 Retina 캡처, 4K 상한, 30fps
입력	CGEvent 이동, 클릭, 키, 스크롤, 드래그. 핀치 줌과 팬
인증	OAuth (GitHub, OIDC) + JWT 회전. 시크릿은 AES-GCM 머신 바인딩 저장
백엔드	Spring Boot 3.4, Java 21. auth, api(디바이스 레지스트리), relay
시험	251개 (Swift 205, Java 46)

자주 받는 질문 셋

Tailscale 없이도 됩니까?

릴레이 폴백이 있어 연결은 됩니다. 기본은 Tailscale 직결이고, 화면 스트리밍 품질도 직결일 때가 좋습니다. Mac 과 iPhone 양쪽에 Tailscale 을 두는 것을 권합니다.

회사 Mac 에 설치해도 됩니까?

에이전트는 화면 기록 권한을 요구하고, 페어링은 내 계정에 기기 지문으로 귀속됩니다. 회사 정책이 화면 기록과 원격 제어를 허용하는지 먼저 확인하세요.

Windows 는요?

호스트는 지금 macOS 만입니다. Windows 호스트와 Mac, Windows 데스크톱 클라이언트는 저장소에 골격만 있고 로드맵입니다.

아이폰에서 내 Mac 을 씁니다.화면, 터미널, 파일까지.