Innei/lody-ios

Independent iOS client for Lody — native chat, sessions, and coding-agent collaboration on iPhone

Lody iOS란 무엇인가

Lody iOS는 Lody AI 어시스턴트 플랫폼을 위한 오픈 소스 커뮤니티 유지 관리 iPhone 클라이언트입니다. 원격 Lody 서비스(「에이전트」)를 네이티브 iOS 앱에 연결하여 채팅 메시지를 보고 스트리밍하며, 원격 작업 공간의 파일 트리를 탐색하고 코드 차이를 확인할 수 있습니다. 이 모든 과정이 일반적인 iOS 앱과 동일한 사용자 경험으로 제공됩니다.

왜 존재하는가

공식 Lody 클라이언트는 iOS 네이티브가 아니기 때문에, 이 프로젝트는 Apple의 Human Interface Guidelines를 따르는 Swift 기반의 React Native UI로 그 공백을 메웁니다.
복잡한 AI 기반 협업 도구가 하이브리드 아키텍처를 사용하여 얼마나 빠르게 구축될 수 있는지(프로토타입에서 TestFlight까지 1주일)를 보여줍니다.

핵심 기술 구성 요소

구성 요소	기능	구현 방식
UI 계층	선언적 화면, 내비게이션, 테마	React Native 0.86 및 Expo Router; 내비게이션과 시트를 위한 네이티브 스택 사용
네이티브 키트 (LodyKit)	고성능 채팅 목록, 마크다운 렌더링, 코드 차이 보기, 키보드 처리	Swift 6 모듈. UIKit/UICollectionView, CoreText 및 사용자 지정 뷰를 RN에 노출
스트리밍 채팅	실시간 AI 생성 텍스트의 글자 단위 표시, 60/120 fps	Swift `UICollectionView` + CoreText `CTRunDraw` 페이드인 애니메이션
CRDT 동기화 엔진	로컬 세션 상태와 원격 Lody 작업 공간 동기화	오프스크린 `WKWebView`에서 Loro/Flock WASM CRDT 코어 실행; Swift 워치독이 모니터링
파일 트리 및 차이 뷰어	원격 프로젝트 파일 탐색, 단어 단위 차이 보기	네이티브 파일 트리 UI + `@pierre/diffs`를 호스팅하는 vendored Expo DOM WebView
실시간 미리보기 / 시뮬레이터 뷰어	앱 내에서 원격 iOS 시뮬레이터 화면 표시	baguette 서버를 사용하여 H.264 프레임을 `AVSampleBufferDisplayLayer`로 스트리밍하고 터치 이벤트 전달
보안	자격 증명의 안전한 저장	iOS Keychain + 표준 OAuth 장치 흐름 인증

주요 기능

Lody 에이전트와 채팅 – 메시지가 실시간으로 스트리밍되며 마크다운(표, 코드, LaTeX)이 네이티브로 렌더링됩니다.
코드 변경 사항 검사 – 각 턴마다 파일 편집 요약이 가능하며, 탭하여 전체 화면 차이 뷰어를 열 수 있습니다.
원격 작업 공간 탐색 – 연결된 Mac이나 서버의 디렉토리와 파일을 보고, 코드를 미리 보거나 Quick-Look을 열 수 있습니다.
개발 서버 실시간 미리보기 – 에이전트가 로컬 개발 URL을 보고하면, "미리보기 칩"을 통해 Safari나 앱 내 뷰에서 직접 사이트를 열 수 있습니다.
원격 iOS 시뮬레이터 실행 – Mac에서 호스팅되는 시뮬레이터의 실시간 영상을 보고 휴대폰에서 직접 조작할 수 있습니다.

시작하기

TestFlight 베타 참여 – https://testflight.apple.com/join/1rR6Ku8f (iOS 26+ 필요).

로컬 빌드 (macOS Sequoia+, Xcode 26.5+, Node ≥ 22, pnpm 11):

git clone https://github.com/Innei/lody-ios.git
cd lody-ios
pnpm install
cd apps/mobile && bundle install   # CocoaPods
pnpm ios   # Xcode 프로젝트 생성 및 시뮬레이터 실행

앱 실행 – 첫 네이티브 빌드 후, pnpm start를 실행하면 핫 리로딩을 위한 React Native 패키저가 시작됩니다.

프로젝트 상태 및 유지 관리

활발한 개발 – "하루 만에 프로토타입, 일주일 만에 출시"라는 스토리가 있으며 main 브랜치가 빠르게 업데이트됩니다. 푸시할 때마다 TestFlight에 빌드가 자동으로 게시됩니다.
테스트 – TypeScript 검사, UI 기준 검증, 시뮬레이터 자동화 테스트 및 전체 테스트 스위트(pnpm test)가 포함되어 있습니다.
라이선스 – AGPL-3.0 전용. 네트워크를 통해 제공되는 모든 수정 사항도 오픈 소스여야 함을 의미합니다.
커뮤니티 – README에는 이것이 타사 클라이언트임을 명시하고 있습니다. 문제는 업스트림이 아닌 이곳에 제기해야 합니다.

누가 사용하면 좋을까요?

iOS 개발자: 네이티브 느낌의 AI 어시스턴트 클라이언트를 원하며 하이브리드 RN/Swift 아키텍처에 관심이 있는 분.
연구원 또는 애호가: 실시간 AI 채팅 스트리밍, CRDT 기반 협업, 모바일 원격 시뮬레이터 상호 작용을 탐구하는 분.
Lody 사용 팀: 공식 클라이언트를 기다리지 않고 iPhone에서 즉시 경험을 원하는 팀.

결론

Lody iOS는 Lody AI 협업 플랫폼을 위한 진정성 있고 기술적으로 정교한 오픈 소스 iOS 클라이언트입니다. React Native UI와 Swift 수준의 성능을 결합하여 채팅 스트리밍, 마크다운 렌더링, CRDT 동기화 및 원격 작업 공간 상호 작용을 구현했으며, AGPL-3.0 라이선스 하에 TestFlight를 통해 배포됩니다.