Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
OpenLens는 Mac 기반의 OpenCode 서버에 연결하여 iPhone 및 iPad에서 사용할 수 있는 iOS 컴패니언 앱입니다. 이 앱을 통해 사용자는 키보드 없이도 AI 코딩 어시스턴트와 채팅하고, 작업 공간 컨텍스트를 탐색하며, 에이전트 질문에 답하는 등 다양한 기능을 휴대폰 환경에서 이용할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기OpenLens
OpenCode의 iOS 컴패니언 앱 — 휴대폰에서 AI 코딩 어시스턴트와 채팅하세요.
<p align="leading"> <a href="https://apps.apple.com/pl/app/openlens-opencode-client/id6759910797"> <img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="App Store에서 다운로드" height="50" /> </a> </p>OpenLens는 Mac에서 실행되는 OpenCode 서버에 연결하여, 키보드 없이도 iPhone 및 iPad의 네이티브 인터페이스를 제공하며 채팅하고, 변경 사항을 검토하고, 작업 공간 컨텍스트(workspace context)를 탐색하고, 에이전트 질문에 답하며, 세션을 관리할 수 있게 합니다.
<p align="center"> <img src="https://raw.githubusercontent.com/martynpekala/OpenLens/HEAD/PromoScreenshots/0x0ss-2.png" width="220" alt="OpenLens 프로모션 스크린샷 1" /> <img src="https://raw.githubusercontent.com/martynpekala/OpenLens/HEAD/PromoScreenshots/0x0ss-3.png" width="220" alt="OpenLens 프로모션 스크린샷 2" /> <img src="https://raw.githubusercontent.com/martynpekala/OpenLens/HEAD/PromoScreenshots/0x0ss-4.png" width="220" alt="OpenLens 프로모션 스크린샷 3" /> </p> <p align="center"> <img src="https://raw.githubusercontent.com/martynpekala/OpenLens/HEAD/PromoScreenshots/0x0ss-5.png" width="220" alt="OpenLens 프로모션 스크린샷 4" /> <img src="https://raw.githubusercontent.com/martynpekala/OpenLens/HEAD/PromoScreenshots/0x0ss-6.png" width="220" alt="OpenLens 프로모션 스크린샷 5" /> <img src="https://raw.githubusercontent.com/martynpekala/OpenLens/HEAD/PromoScreenshots/0x0ss-7.png" width="220" alt="OpenLens 프로모션 스크린샷 6" /> </p>xcodegen generate를 실행한 다음, Xcode 26 이상에서 생성된 OpenLens.xcodeproj를 여세요.main 브랜치 또는 태그가 지정된 리비전에서 빌드할 수 있습니다.openlens:// 딥 링크 지원curl -fsSL https://opencode.ai/install | bash
opencode serve --port 4096 --hostname 0.0.0.0
Bonjour를 통해 OpenLens가 서버를 찾도록 하려면 --mdns를 추가하십시오. 비밀번호가 필요하도록 설정하려면 시작 전에 OPENCODE_SERVER_PASSWORD를 설정하세요.
opencode pair를 실행한 후, "QR 코드 스캔"을 탭하고 터미널을 향해 비춥니다.--mdns로 시작하세요)"를 탭합니다.192.168.1.50:4096).이것으로 끝입니다. 휴대폰에서 AI 코딩 어시스턴트와 채팅할 수 있습니다.
컴퓨터에서 opencode pair를 실행하거나, 인터넷을 통해 연결하려면 opencode pair --remote를 사용합니다. OpenCode의 HTTPS 터널을 통해 연결됩니다. 생성된 페어링 링크를 OpenLens의 서버 주소 필드에 붙여넣고 **연결(Connect)**을 탭하거나 QR 코드를 스캔하세요. OpenLens는 code와 urls가 포함된 현재 JSON QR 페이로드를, 단일 사용 http(s)://<host>/auth/connect/<code> 링크, 그리고 구형 http(s)://<host>/connect#<credentials> 링크를 수락합니다. 여러 주소가 포함된 QR의 경우, 모든 주소를 함께 시도하고 성공적으로 페어링되는 주소를 저장합니다.
OpenLens는 페어링 자격 증명을 해석하여 이후 연결을 위해 키체인(Keychain)에 저장합니다. 비밀번호를 입력할 필요가 없습니다. 단일 사용 코드는 5분 후에 만료되므로, 링크가 만료되었거나 이미 브라우저에서 열린 경우 opencode pair를 다시 실행하세요. 페어링 성공 후 연결이 실패하면, **다시 시도(Try Again)**는 저장된 토큰을 사용합니다.
사용자의 iPhone은 링크에 있는 호스트에 도달할 수 있어야 합니다. 사설 LAN 주소의 경우 해당 네트워크(직접 또는 VPN을 통해)에 대한 접근 권한이 필요합니다.
--remote를 사용하는 경우, iPhone은 다른 Wi-Fi 네트워크나 셀룰러 데이터를 사용할 수 있습니다. 컴퓨터와 OpenCode 백그라운드 서비스, 그리고 터널은 계속 실행 상태로 유지해야 합니다.
OpenLens/ — 메인 iOS 앱OpenLensActivityWidget/ — 라이브 액티비티 위젯 확장(Live Activity widget extension)OpenLensTests/ — 단위 테스트(unit tests)brew install xcodegen으로 XcodeGen을 설치한 후, xcodegen generate를 실행합니다.OpenLens.xcodeproj를 엽니다.Config/Signing.local.xcconfig.example을 Config/Signing.local.xcconfig로 복사하고 팀(team), 번들 식별자(bundle identifiers), 앱 그룹(App Group) 값을 본인 값으로 교체합니다.저장소 루트에서 메인 검증 명령어를 실행하세요:
./scripts/test-ios.sh
Python 3/툴 요구 사항, 시뮬레이터 선택, 집중 테스트 실행(focused test runs), 시간 제한, 복구 로그 등은 CONTRIBUTING.md를 참조하세요.
설정 및 PR 기대치에 대해서는 CONTRIBUTING.md를, 취약점 보고(vulnerability reporting)에 대해서는 SECURITY.md를, 커뮤니티 가이드라인에 대해서는 CODE_OF_CONDUCT.md를 참조하세요.
이 프로젝트는 OpenCode 팀에서 제작한 것이 아니며, 어떠한 방식으로도 OpenCode와 제휴하지 않습니다.
OpenLens는 자동 연결을 위해 openlens:// URL 스킴을 지원합니다:
openlens://connect?url=192.168.1.50:4096&user=opencode&pass=optional&sessionID=abc123
만약 sessionID가 존재하면, OpenLens가 먼저 연결한 후 해당 세션을 자동으로 엽니다.
서버 상세 정보 없이 OpenCode v2 지원을 홍보하려면 (예를 들어 앱 스토어 인앱 이벤트 딥 링크로), 다음을 사용하세요:
openlens://setup
연결이 없을 경우, OpenLens는 연결 설정을 보여줍니다. 연결되었거나 저장된 서버에 재연결하는 경우에는, 대신 서버에서 감지된 버전과 함께 OpenCode v2 지원 화면을 보여줍니다.
본 프로젝트는 MIT License 하에 라이선스가 부여됩니다.