Innei/lody-ios

Lody iOS – What It Is

Lody iOS is an open‑source, community‑maintained iPhone client for the Lody AI‑assistant platform. It lets you connect a remote Lody service (the “agent”) to a native iOS app, view and stream chat messages, browse a remote workspace’s file tree, and see code diffs – all while looking and feeling like a regular iOS app.

---

Why It Exists

• The official Lody client is not iOS‑native, so this project fills the gap with a Swift‑backed, React‑Native UI that follows Apple’s Human Interface Guidelines.
• It demonstrates that a complex AI‑driven collaboration tool can be built quickly (prototype → TestFlight in a week) using a hybrid architecture.

---

Core Technical Pieces

Piece	What It Does	How It’s Implemented
UI Layer	Declarative screens, navigation, theming	React Native 0.86 with Expo Router; native stack for navigation and sheets
Native Kit (LodyKit)	High‑performance chat list, markdown rendering, code diff view, keyboard handling	Swift 6 module exposing UIKit/UICollectionView, CoreText, and custom views to RN
Streaming Chat	Real‑time AI‑generated text appears character‑by‑character, 60/120 fps	Swift UICollectionView + CoreText CTRunDraw fade‑in animation
CRDT Sync Engine	Keeps local session state in sync with remote Lody workspaces	Off‑screen WKWebView runs the Loro/Flock WASM CRDT core; Swift watchdog monitors it
File‑tree & Diff Viewer	Browse remote project files, view word‑level diffs	Native file‑tree UI + a vendored Expo DOM WebView that hosts @pierre/diffs
Live Preview / Simulator Viewer	Shows a remote iOS simulator screen inside the app	Uses the baguette server to stream H.264 frames into AVSampleBufferDisplayLayer and forwards touch events back
Security	Stores credentials safely	iOS Keychain + standard OAuth device‑flow authentication

---

What You Can Do With It

1. Chat with an Lody agent – messages stream in real time, markdown (tables, code, LaTeX) renders natively.
2. Inspect code changes – each turn can summarise file edits; tap to open a full‑screen diff view.
3. Browse a remote workspace – view directories and files on a connected Mac or server, preview code, or open Quick‑Look.
4. Live preview a dev server – when the agent reports a local dev URL, a “preview chip” opens the tunnel‑served site directly in Safari or an in‑app view.
5. Run a remote iOS simulator – watch a live video of a Mac‑hosted simulator and interact with it from your phone.

---

How to Get Started

1. Join the TestFlight beta – https://testflight.apple.com/join/1rR6Ku8f (requires iOS 26+).
2. Build locally (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   # generates Xcode project and launches the simulator
   

3. Run the app – after the first native build, pnpm start will launch the React‑Native packager for hot‑reloading.

---

Project Health & Maintenance

• Active development – the repo notes a “prototype in a day, shipped in a week” story and a fast‑moving main branch. Builds are automatically published to TestFlight on every push.
• Testing – includes TypeScript checks, UI baseline verification, simulator‑automation tests, and a full test suite (pnpm test).
• License – AGPL‑3.0‑only, meaning any network‑served modifications must also be open‑source.
• Community – the README warns that this is a third‑party client; issues should be filed here, not upstream.

---

Who Might Find This Useful?

• iOS developers who want a native‑looking AI‑assistant client and are curious about hybrid RN/Swift architectures.
• Researchers or hobbyists exploring real‑time AI chat streaming, CRDT‑based collaboration, or remote simulator interaction on mobile.
• Teams using Lody that need an iPhone‑first experience without waiting for an official client.

---

Bottom Line

Lody iOS is a genuine, technically sophisticated open‑source iOS client for the Lody AI collaboration platform. It combines React‑Native UI with Swift‑level performance for chat streaming, markdown rendering, CRDT sync, and remote workspace interaction, all packaged under an AGPL‑3.0 license and distributed via TestFlight.