YukkaiBridge — Mac to iPhone Sync
YukkaiBridge keeps your Yukkai experience synchronized between your Mac and iPhone, so your conversations, settings, and memory follow you across devices.
YukkaiBridge is Yukkai's cross-device synchronization layer. It ensures that your AI agent's state — conversations, memory, preferences, design systems, and skills — stays consistent between your Mac and your iPhone.
Why YukkaiBridge Matters
Yukkai is a native macOS and iOS app built with SwiftUI and Swift Concurrency. While the Mac version is the powerhouse (with full tool access, desktop automation, AI browser, and swarm orchestration), the iPhone version gives you a lightweight, on-the-go companion. YukkaiBridge connects the two.
What Syncs
| Data | Direction | Notes |
|---|---|---|
| Conversation history | Mac ↔ iPhone | Active and past sessions sync across devices |
| Human Memory | Mac ↔ iPhone | Identity, preferences, patterns, and episodic memory are shared |
| RAG knowledge base | Mac → iPhone | Indexed project documents sync to iPhone for offline search |
| Design systems | Mac ↔ iPhone | Visual identity tokens stay consistent for code generation |
| Skills | Mac ↔ iPhone | Active skills and their system prompts sync across devices |
| Settings | Mac ↔ iPhone | Security settings, permissions, and preferences |
| Agent roles | Mac ↔ iPhone | Swarm role definitions are shared |
How It Works
YukkaiBridge uses Apple's native Continuity infrastructure to establish a secure, peer-to-peer connection between your Mac and iPhone. No cloud servers are involved — all data is transferred directly between your devices over an encrypted channel.
Mac (Yukkai) ←→ [Encrypted P2P Channel] ←→ iPhone (Yukkai)Architecture
The bridge operates within Yukkai's ConversationEngine on both devices:
- Change detection — When a conversation, memory entry, or setting changes on one device, the bridge detects it.
- Delta sync — Only the changed data is transmitted, not the entire dataset.
- Conflict resolution — When both devices have changes to the same item, the most recent timestamp wins.
- Secure transfer — All data is encrypted in transit using the same AES-256-GCM standard as the Vault.
Security
YukkaiBridge maintains the same security posture as the rest of Yukkai:
- No cloud intermediary — Data goes directly from Mac to iPhone, never through third-party servers
- Encrypted in transit — AES-256-GCM encryption on all synced data
- Same security gates apply — SecretDetector, InjectionDetector, and PathGuard process synced data on arrival
- Biometric protection — On iPhone, synced data inherits TouchID/FaceID protection
Use Cases
- Start on Mac, continue on iPhone — Begin a complex coding session on your Mac, then review the conversation on your iPhone while commuting.
- Memory follows you — Yukkai remembers your preferences and patterns regardless of which device you're using.
- Instant access to knowledge — Your indexed project documents are available for RAG search on both devices.
- Consistent design systems — If you set up a design system on your Mac, it's immediately available on your iPhone for code generation tasks.
Setting Up YukkaiBridge
- Ensure both your Mac and iPhone have Yukkai installed.
- Sign in with the same account on both devices.
- Ensure both devices are on the same Wi-Fi network (for initial pairing).
- Open Settings → YukkaiBridge on your Mac.
- Your iPhone should appear in the list of available devices.
- Tap Pair and confirm on both devices.
- Sync begins automatically — you'll see a status indicator when data is being transferred.