라이브 미리보기
Mac/PC에서 실행 중인 것을 BuddyOS 앱에서 바로 보고 만져 보세요.
최종 업데이트: 2026년 10월 20일
라이브 미리보기는 AI 버디가 실행한 iOS 시뮬레이터나 Mac/PC에서 돌아가는 로컬 개발 서버(localhost)를 휴대폰의 BuddyOS 앱에서 보고 조작할 수 있는 개발자용 기능이에요.
영상과 입력은 대화와 같은 암호화 경로를 통해 Mac/PC에서 실행 중인 Bridge가 전달해요.
1. 어떤 기능인가요
AI에게 “앱을 실행해 줘”나 “개발 서버를 시작해 줘”라고 요청한 뒤, 결과를 휴대폰에서 바로 확인할 수 있어요. iOS 시뮬레이터는 실시간 영상을 탭하고 스와이프해서 조작할 수 있고, 로컬 웹 서버는 앱 내 브라우저에서 localhost를 열 수 있어요.
화면의 출처는 내 Mac/PC에서 실행 중인 BuddyOS Bridge예요. 영상과 입력은 암호화된 경로로 전달되므로 내 기기의 내용만 볼 수 있고, 공개 인터넷에는 아무것도 노출되지 않아요.
2. 할 수 있는 일
- iOS 시뮬레이터(macOS 전용): 실시간 영상과 탭 / 스와이프 / 텍스트 입력 / 홈 제스처.
- Android 에뮬레이터·실기기(Windows 전용): adb로 연결한 기기의 실시간 영상과 탭 / 스와이프 / 텍스트 입력 / 홈 제스처.
- 웹 로컬(Mac & Windows): 앱 안에서 localhost:PORT를 표시해요. 추가 다운로드 없이 개발 서버만 실행 중이면 바로 동작해요.
- 에이전트 출력의 localhost URL을 탭하고 “미리보기에서 열기”를 누르면 바로 전환돼요.
- 미리보기를 스크린샷으로 찍어 채팅 입력창에 첨부하고 에이전트에게 다시 보낼 수 있어요.
시뮬레이터 조작(탭 / 스와이프 / 텍스트 / 홈)은 macOS Bridge가, Android 에뮬레이터·실기기 조작은 Windows Bridge가 제공해요(Windows에서는 iOS 시뮬레이터가 동작하지 않기 때문이에요).
3. 필요한 것(macOS의 iOS 시뮬레이터용)
| 도구 | 역할 | 구하는 방법 |
|---|---|---|
| Xcode | 시뮬레이터와 simctl / sips를 제공해요. 탭 같은 조작도 이것만으로 동작해요 | App Store에서 설치하세요(sips는 macOS에 포함되어 있어 따로 받을 필요 없어요) |
웹 로컬 미리보기는 추가 다운로드가 전혀 필요 없어요. 개발 서버가 localhost에서 실행 중이면 그대로 열 수 있어요.
Windows에서 Android를 쓰려면: Android Studio(또는 Android SDK의 platform-tools)를 설치해 adb를 쓸 수 있게 한 뒤, 에뮬레이터를 실행하거나 USB 디버깅을 켠 실기기를 연결하세요. Bridge가 Android SDK 위치(ANDROID_HOME 등)나 PATH에서 adb를 자동으로 찾아요.
4. 설정
- App Store에서 Xcode를 설치하세요(simctl / sips를 사용할 수 있게 돼요).
- 휴대폰을 Mac과 페어링하세요(이미 했다면 건너뛰세요).
- BuddyOS 앱 오른쪽 위의 미리보기(오른쪽 패널) 아이콘을 탭해서 여세요.
5. 참고
- 개발자용 기능이에요. Bridge가 실행 중인 내 Mac/PC의 화면을 그대로 보여 주는 기능이며, 일반 사용자를 위한 기능은 아니에요.
- iOS 시뮬레이터 미리보기와 제어는 macOS 전용, Android 에뮬레이터·실기기 미리보기와 제어는 Windows 전용이에요. 웹 로컬 미리보기는 둘 다 지원해요.
- 추가로 내려받을 것은 없어요(Xcode만 있으면 동작해요).