Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

docs: iOS UI architecture redesign spec + Claude/Codex tab icons

libokai159baf54e73a
diff --git a/Codync-iOS/Assets.xcassets/ClaudeColorIcon.imageset/Contents.json b/Codync-iOS/Assets.xcassets/ClaudeColorIcon.imageset/Contents.json
new file mode 100644
index 00000000..73701f60
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/ClaudeColorIcon.imageset/Contents.json
@@ -0,0 +1,16 @@
+{
+ "images" : [
+ {
+ "filename" : "claude-color.svg",
+ "idiom" : "universal"
+ }
+ ],
+ "info" : {
+ "author" : "xcode",
+ "version" : 1
+ },
+ "properties" : {
+ "preserves-vector-representation" : true,
+ "template-rendering-intent" : "original"
+ }
+}
diff --git a/Codync-iOS/Assets.xcassets/ClaudeColorIcon.imageset/claude-color.svg b/Codync-iOS/Assets.xcassets/ClaudeColorIcon.imageset/claude-color.svg
new file mode 100644
index 00000000..62dc0db1
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/ClaudeColorIcon.imageset/claude-color.svg
@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Claude</title><path d="M4.709 15.955l4.72-2.647.08-.23-.08-.128H9.2l-.79-.048-2.698-.073-2.339-.097-2.266-.122-.571-.121L0 11.784l.055-.352.48-.321.686.06 1.52.103 2.278.158 1.652.097 2.449.255h.389l.055-.157-.134-.098-.103-.097-2.358-1.596-2.552-1.688-1.336-.972-.724-.491-.364-.462-.158-1.008.656-.722.881.06.225.061.893.686 1.908 1.476 2.491 1.833.365.304.145-.103.019-.073-.164-.274-1.355-2.446-1.446-2.49-.644-1.032-.17-.619a2.97 2.97 0 01-.104-.729L6.283.134 6.696 0l.996.134.42.364.62 1.414 1.002 2.229 1.555 3.03.456.898.243.832.091.255h.158V9.01l.128-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.584.28.48.685-.067.444-.286 1.851-.559 2.903-.364 1.942h.212l.243-.242.985-1.306 1.652-2.064.73-.82.85-.904.547-.431h1.033l.76 1.129-.34 1.166-1.064 1.347-.881 1.142-1.264 1.7-.79 1.36.073.11.188-.02 2.856-.606 1.543-.28 1.841-.315.833.388.091.395-.328.807-1.969.486-2.309.462-3.439.813-.042.03.049.061 1.549.146.662.036h1.622l3.02.225.79.522.474.638-.079.485-1.215.62-1.64-.389-3.829-.91-1.312-.329h-.182v.11l1.093 1.068 2.006 1.81 2.509 2.33.127.578-.322.455-.34-.049-2.205-1.657-.851-.747-1.926-1.62h-.128v.17l.444.649 2.345 3.521.122 1.08-.17.353-.608.213-.668-.122-1.374-1.925-1.415-2.167-1.143-1.943-.14.08-.674 7.254-.316.37-.729.28-.607-.461-.322-.747.322-1.476.389-1.924.315-1.53.286-1.9.17-.632-.012-.042-.14.018-1.434 1.967-2.18 2.945-1.726 1.845-.414.164-.717-.37.067-.662.401-.589 2.388-3.036 1.44-1.882.93-1.086-.006-.158h-.055L4.132 18.56l-1.13.146-.487-.456.061-.746.231-.243 1.908-1.312-.006.006z" fill="#D97757" fill-rule="nonzero"></path></svg>
\ No newline at end of file
diff --git a/Codync-iOS/Assets.xcassets/ClaudeIcon.imageset/Contents.json b/Codync-iOS/Assets.xcassets/ClaudeIcon.imageset/Contents.json
new file mode 100644
index 00000000..9eea8384
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/ClaudeIcon.imageset/Contents.json
@@ -0,0 +1,16 @@
+{
+ "images" : [
+ {
+ "filename" : "claude.svg",
+ "idiom" : "universal"
+ }
+ ],
+ "info" : {
+ "author" : "xcode",
+ "version" : 1
+ },
+ "properties" : {
+ "preserves-vector-representation" : true,
+ "template-rendering-intent" : "template"
+ }
+}
diff --git a/Codync-iOS/Assets.xcassets/ClaudeIcon.imageset/claude.svg b/Codync-iOS/Assets.xcassets/ClaudeIcon.imageset/claude.svg
new file mode 100644
index 00000000..e29f3282
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/ClaudeIcon.imageset/claude.svg
@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Claude</title><path d="M4.709 15.955l4.72-2.647.08-.23-.08-.128H9.2l-.79-.048-2.698-.073-2.339-.097-2.266-.122-.571-.121L0 11.784l.055-.352.48-.321.686.06 1.52.103 2.278.158 1.652.097 2.449.255h.389l.055-.157-.134-.098-.103-.097-2.358-1.596-2.552-1.688-1.336-.972-.724-.491-.364-.462-.158-1.008.656-.722.881.06.225.061.893.686 1.908 1.476 2.491 1.833.365.304.145-.103.019-.073-.164-.274-1.355-2.446-1.446-2.49-.644-1.032-.17-.619a2.97 2.97 0 01-.104-.729L6.283.134 6.696 0l.996.134.42.364.62 1.414 1.002 2.229 1.555 3.03.456.898.243.832.091.255h.158V9.01l.128-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.584.28.48.685-.067.444-.286 1.851-.559 2.903-.364 1.942h.212l.243-.242.985-1.306 1.652-2.064.73-.82.85-.904.547-.431h1.033l.76 1.129-.34 1.166-1.064 1.347-.881 1.142-1.264 1.7-.79 1.36.073.11.188-.02 2.856-.606 1.543-.28 1.841-.315.833.388.091.395-.328.807-1.969.486-2.309.462-3.439.813-.042.03.049.061 1.549.146.662.036h1.622l3.02.225.79.522.474.638-.079.485-1.215.62-1.64-.389-3.829-.91-1.312-.329h-.182v.11l1.093 1.068 2.006 1.81 2.509 2.33.127.578-.322.455-.34-.049-2.205-1.657-.851-.747-1.926-1.62h-.128v.17l.444.649 2.345 3.521.122 1.08-.17.353-.608.213-.668-.122-1.374-1.925-1.415-2.167-1.143-1.943-.14.08-.674 7.254-.316.37-.729.28-.607-.461-.322-.747.322-1.476.389-1.924.315-1.53.286-1.9.17-.632-.012-.042-.14.018-1.434 1.967-2.18 2.945-1.726 1.845-.414.164-.717-.37.067-.662.401-.589 2.388-3.036 1.44-1.882.93-1.086-.006-.158h-.055L4.132 18.56l-1.13.146-.487-.456.061-.746.231-.243 1.908-1.312-.006.006z"></path></svg>
\ No newline at end of file
diff --git a/Codync-iOS/Assets.xcassets/CodexColorIcon.imageset/Contents.json b/Codync-iOS/Assets.xcassets/CodexColorIcon.imageset/Contents.json
new file mode 100644
index 00000000..1293fe99
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/CodexColorIcon.imageset/Contents.json
@@ -0,0 +1,16 @@
+{
+ "images" : [
+ {
+ "filename" : "codex-color.svg",
+ "idiom" : "universal"
+ }
+ ],
+ "info" : {
+ "author" : "xcode",
+ "version" : 1
+ },
+ "properties" : {
+ "preserves-vector-representation" : true,
+ "template-rendering-intent" : "original"
+ }
+}
diff --git a/Codync-iOS/Assets.xcassets/CodexColorIcon.imageset/codex-color.svg b/Codync-iOS/Assets.xcassets/CodexColorIcon.imageset/codex-color.svg
new file mode 100644
index 00000000..d5cb0ac4
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/CodexColorIcon.imageset/codex-color.svg
@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Codex</title><path d="M19.503 0H4.496A4.496 4.496 0 000 4.496v15.007A4.496 4.496 0 004.496 24h15.007A4.496 4.496 0 0024 19.503V4.496A4.496 4.496 0 0019.503 0z" fill="#fff"></path><path d="M9.064 3.344a4.578 4.578 0 012.285-.312c1 .115 1.891.54 2.673 1.275.01.01.024.017.037.021a.09.09 0 00.043 0 4.55 4.55 0 013.046.275l.047.022.116.057a4.581 4.581 0 012.188 2.399c.209.51.313 1.041.315 1.595a4.24 4.24 0 01-.134 1.223.123.123 0 00.03.115c.594.607.988 1.33 1.183 2.17.289 1.425-.007 2.71-.887 3.854l-.136.166a4.548 4.548 0 01-2.201 1.388.123.123 0 00-.081.076c-.191.551-.383 1.023-.74 1.494-.9 1.187-2.222 1.846-3.711 1.838-1.187-.006-2.239-.44-3.157-1.302a.107.107 0 00-.105-.024c-.388.125-.78.143-1.204.138a4.441 4.441 0 01-1.945-.466 4.544 4.544 0 01-1.61-1.335c-.152-.202-.303-.392-.414-.617a5.81 5.81 0 01-.37-.961 4.582 4.582 0 01-.014-2.298.124.124 0 00.006-.056.085.085 0 00-.027-.048 4.467 4.467 0 01-1.034-1.651 3.896 3.896 0 01-.251-1.192 5.189 5.189 0 01.141-1.6c.337-1.112.982-1.985 1.933-2.618.212-.141.413-.251.601-.33.215-.089.43-.164.646-.227a.098.098 0 00.065-.066 4.51 4.51 0 01.829-1.615 4.535 4.535 0 011.837-1.388zm3.482 10.565a.637.637 0 000 1.272h3.636a.637.637 0 100-1.272h-3.636zM8.462 9.23a.637.637 0 00-1.106.631l1.272 2.224-1.266 2.136a.636.636 0 101.095.649l1.454-2.455a.636.636 0 00.005-.64L8.462 9.23z" fill="url(#lobe-icons-codex-fill)"></path><defs><linearGradient gradientUnits="userSpaceOnUse" id="lobe-icons-codex-fill" x1="12" x2="12" y1="3" y2="21"><stop stop-color="#B1A7FF"></stop><stop offset=".5" stop-color="#7A9DFF"></stop><stop offset="1" stop-color="#3941FF"></stop></linearGradient></defs></svg>
\ No newline at end of file
diff --git a/Codync-iOS/Assets.xcassets/CodexIcon.imageset/Contents.json b/Codync-iOS/Assets.xcassets/CodexIcon.imageset/Contents.json
new file mode 100644
index 00000000..9fc95103
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/CodexIcon.imageset/Contents.json
@@ -0,0 +1,16 @@
+{
+ "images" : [
+ {
+ "filename" : "codex.svg",
+ "idiom" : "universal"
+ }
+ ],
+ "info" : {
+ "author" : "xcode",
+ "version" : 1
+ },
+ "properties" : {
+ "preserves-vector-representation" : true,
+ "template-rendering-intent" : "template"
+ }
+}
diff --git a/Codync-iOS/Assets.xcassets/CodexIcon.imageset/codex.svg b/Codync-iOS/Assets.xcassets/CodexIcon.imageset/codex.svg
new file mode 100644
index 00000000..4c648aff
--- /dev/null
+++ b/Codync-iOS/Assets.xcassets/CodexIcon.imageset/codex.svg
@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Codex</title><path clip-rule="evenodd" d="M8.086.457a6.105 6.105 0 013.046-.415c1.333.153 2.521.72 3.564 1.7a.117.117 0 00.107.029c1.408-.346 2.762-.224 4.061.366l.063.03.154.076c1.357.703 2.33 1.77 2.918 3.198.278.679.418 1.388.421 2.126a5.655 5.655 0 01-.18 1.631.167.167 0 00.04.155 5.982 5.982 0 011.578 2.891c.385 1.901-.01 3.615-1.183 5.14l-.182.22a6.063 6.063 0 01-2.934 1.851.162.162 0 00-.108.102c-.255.736-.511 1.364-.987 1.992-1.199 1.582-2.962 2.462-4.948 2.451-1.583-.008-2.986-.587-4.21-1.736a.145.145 0 00-.14-.032c-.518.167-1.04.191-1.604.185a5.924 5.924 0 01-2.595-.622 6.058 6.058 0 01-2.146-1.781c-.203-.269-.404-.522-.551-.821a7.74 7.74 0 01-.495-1.283 6.11 6.11 0 01-.017-3.064.166.166 0 00.008-.074.115.115 0 00-.037-.064 5.958 5.958 0 01-1.38-2.202 5.196 5.196 0 01-.333-1.589 6.915 6.915 0 01.188-2.132c.45-1.484 1.309-2.648 2.577-3.493.282-.188.55-.334.802-.438.286-.12.573-.22.861-.304a.129.129 0 00.087-.087A6.016 6.016 0 015.635 2.31C6.315 1.464 7.132.846 8.086.457zm-.804 7.85a.848.848 0 00-1.473.842l1.694 2.965-1.688 2.848a.849.849 0 001.46.864l1.94-3.272a.849.849 0 00.007-.854l-1.94-3.393zm5.446 6.24a.849.849 0 000 1.695h4.848a.849.849 0 000-1.696h-4.848z"></path></svg>
\ No newline at end of file
diff --git a/docs/superpowers/specs/2026-03-21-ios-ui-architecture-redesign.md b/docs/superpowers/specs/2026-03-21-ios-ui-architecture-redesign.md
new file mode 100644
index 00000000..179e8fcd
--- /dev/null
+++ b/docs/superpowers/specs/2026-03-21-ios-ui-architecture-redesign.md
@@ -0,0 +1,351 @@
+# iOS UI Architecture Redesign — Design Spec
+
+**Date:** 2026-03-21
+**Status:** Approved
+**Approach:** Incremental refactor (方案 A)
+
+## Overview
+
+Restructure the Codync iOS app from a flat `NavigationStack` into a tabbed architecture with dual Live Activity modes (Overall / Individual) and a Primary Session concept.
+
+## Confirmed Requirements
+
+- Bottom `TabView` with three tabs: Claude Code, Cowork (Coming Soon), Codex (Coming Soon)
+- Live Activity dual mode: Overall (unified) + Individual (per-session), top Segmented Control to switch
+- Overall mode shows max 4 sessions
+- Primary Session: hybrid mode — auto-select most active, user can manually lock
+- Primary shown on Dynamic Island and Apple Watch (future)
+- AppDelegate consolidates all initialization (CloudKit fetch, pins, preferences, notification auth)
+- Icons from lobehub/lobe-icons (MIT License), stored in Asset Catalog as SVG
+
+## Section 1: Tab Architecture
+
+### View Hierarchy
+
+```
+CodyncIOSApp
+└── IOSRootView (retains onboarding gate)
+ ├── IOSOnboardingView (first launch)
+ └── TabRootView (post-onboarding)
+ ├── Tab 1: Claude Code (image: "ClaudeIcon")
+ │ └── NavigationStack
+ │ ├── IOSSessionListView (reused)
+ │ └── IOSSessionDetailView (reused)
+ ├── Tab 2: Cowork (systemImage: "person.2.fill") — Coming Soon
+ │ └── ComingSoonView
+ └── Tab 3: Codex (image: "CodexIcon") — Coming Soon
+ └── ComingSoonView
+```
+
+### New Files
+
+- `Codync-iOS/Views/TabRootView.swift` — `TabView` container with `@AppStorage("selectedTab")` persistence
+- `Codync-iOS/Views/ComingSoonView.swift` — Generic placeholder (icon + title + description)
+
+### Key Decisions
+
+- Each tab has its own `NavigationStack` — independent navigation stacks
+- Tab selection persisted via `@AppStorage` — restores last tab on relaunch
+- iOS 26 automatically applies liquid glass tab bar effect — no custom styling needed
+- `IOSRootView` retains onboarding gate logic, delegates to `TabRootView` after completion
+
+### Tab Enum
+
+```swift
+enum AppTab: String, CaseIterable {
+ case claudeCode
+ case cowork
+ case codex
+}
+```
+
+## Section 2: Live Activity Dual Mode
+
+### Mode Switcher UI
+
+Top of Sessions tab (`IOSSessionListView`):
+
+```
+┌──────────────────────────────────┐
+│ [Overall] [Individual] │ ← Picker, SegmentedPickerStyle
+├──────────────────────────────────┤
+│ (Overall mode extra controls) │
+│ Primary: ByCrawl ★ │
+│ Max sessions: [1][2][3][4] │
+├──────────────────────────────────┤
+│ Session list... │
+└──────────────────────────────────┘
+```
+
+- `Picker` with `.segmentedPickerStyle()` in a `Section` header or toolbar area
+- Overall-only controls (primary selector, max session count) shown conditionally
+- Mode persisted via CloudKit `LiveActivityPreference` record
+
+### Data Model Changes (CodyncShared)
+
+**New: `OverallAttributes`**
+
+```swift
+struct OverallAttributes: ActivityAttributes {
+ struct ContentState: Codable, Hashable {
+ let sessions: [SessionSummary]
+ let primarySessionId: String?
+ let totalCost: Double
+ }
+}
+```
+
+**New: `SessionSummary`**
+
+```swift
+struct SessionSummary: Codable, Hashable, Sendable {
+ let sessionId: String
+ let projectName: String
+ let status: SessionStatus
+ let model: String
+ let currentTask: String?
+ let costUSD: Double
+}
+```
+
+**New: `LiveActivityMode`**
+
+```swift
+enum LiveActivityMode: String, Codable, Sendable {
+ case overall
+ case individual
+}
+```
+
+Existing `CodyncAttributes` remains unchanged — used for Individual mode.
+
+### LiveActivityManager Extension
+
+```swift
+@MainActor
+class LiveActivityManager: ObservableObject {
+ @Published var mode: LiveActivityMode = .overall
+
+ // Existing (Individual mode)
+ var activities: [String: Activity<CodyncAttributes>]
+ var trackedSessionIds: Set<String>
+ var pinnedSessionIds: Set<String>
+
+ // New (Overall mode)
+ var overallActivity: Activity<OverallAttributes>?
+
+ func updateSessions(_ sessions: [SessionState]) {
+ switch mode {
+ case .overall: updateOverall(sessions)
+ case .individual: updateIndividual(sessions) // existing logic
+ }
+ }
+
+ func switchMode(to newMode: LiveActivityMode) {
+ // 1. End all current activities (individual or overall)
+ // 2. Reset transient state: previousTasks, secondPreviousTasks, grace periods
+ // 3. Switch mode
+ // 4. Recreate activities in new mode from current session data
+ }
+
+ func loadPreference() async {
+ // Fetch mode + maxSessions from CloudKit
+ }
+}
+```
+
+### Overall Mode Layout Adaptation (Live Activity Widget)
+
+| Session Count | Layout | Details |
+|---|---|---|
+| 1 | Full detail | Tool cards + timer + stacking, similar to Individual |
+| 2–3 | Medium rows | Status dot + project + model + currentTask |
+| 4 | Compact rows | Status dot + project name only |
+
+Dynamic Island always shows primary session only.
+
+### PrimarySessionManager (New)
+
+```swift
+@MainActor
+final class PrimarySessionManager: ObservableObject {
+ @Published var primarySessionId: String?
+ @Published var isManuallyLocked: Bool = false
+
+ /// Priority order matches LiveActivityManager.autoFillPriority:
+ /// working(5) > needsInput(4) > compacting(3) > idle/error(2) > completed(0)
+ func autoSelect(from sessions: [SessionState]) {
+ guard !isManuallyLocked else { return }
+ primarySessionId = sessions
+ .sorted { autoFillPriority($0) > autoFillPriority($1) }
+ .first?.sessionId
+ }
+
+ private func autoFillPriority(_ s: SessionState) -> Int {
+ switch s.status {
+ case .working: 5
+ case .needsInput: 4
+ case .compacting: 3
+ case .idle, .error: 2
+ case .completed: 0
+ }
+ }
+
+ func manualLock(_ sessionId: String) {
+ primarySessionId = sessionId
+ isManuallyLocked = true
+ }
+
+ func unlock() {
+ isManuallyLocked = false
+ // autoSelect will run on next updateSessions
+ }
+
+ func load() async {
+ // Fetch from CloudKit PrimarySession record
+ }
+
+ func save() async {
+ // Persist to CloudKit PrimarySession record
+ }
+}
+```
+
+- If manually locked session disappears from CloudKit → auto-unlock and select next
+- CloudKit persistence allows macOS to read the primary session choice
+
+## Section 3: CloudKit Changes
+
+### New Record Types
+
+**PrimarySession** (singleton, fixed `recordName: "primary-session"`):
+
+| Field | Type | Description |
+|---|---|---|
+| sessionId | String | Currently selected primary session |
+| isManuallyLocked | Bool | Whether user manually locked this choice |
+| updatedAt | Date | Last modification time |
+
+**LiveActivityPreference** (singleton, fixed `recordName: "live-activity-pref"`):
+
+| Field | Type | Description |
+|---|---|---|
+| mode | String | "overall" or "individual" |
+| maxSessions | Int | 1–4, used in Overall mode |
+
+### CloudKitManager Additions
+
+```swift
+extension CloudKitManager {
+ func fetchPrimarySession() async -> (sessionId: String?, locked: Bool)
+ func setPrimarySession(_ sessionId: String, locked: Bool) async
+ func clearPrimarySession() async
+
+ func fetchLiveActivityPreference() async -> (mode: LiveActivityMode, maxSessions: Int)
+ func setLiveActivityPreference(mode: LiveActivityMode, maxSessions: Int) async
+}
+```
+
+Both records use fixed `recordName` values to ensure only one instance exists (upsert semantics).
+
+## Section 4: AppDelegate Consolidation
+
+### Before (scattered initialization)
+
+```swift
+// AppDelegate: only APNs registration
+// CodyncIOSApp .task {}: receiver.start(), loadPinnedSessions(), notification auth
+```
+
+### After (unified initialization)
+
+```swift
+final class AppDelegate: NSObject, UIApplicationDelegate {
+ let receiver = CloudKitReceiver()
+ let liveActivityManager = LiveActivityManager()
+ let primarySessionManager = PrimarySessionManager()
+
+ func application(_ application: UIApplication,
+ didFinishLaunchingWithOptions ...) -> Bool {
+ application.registerForRemoteNotifications()
+ Task {
+ async let startReceiver: () = receiver.start()
+ async let loadPins: () = liveActivityManager.loadPinnedSessions()
+ async let loadPrimary: () = primarySessionManager.load()
+ async let loadPref: () = liveActivityManager.loadPreference()
+ _ = await (startReceiver, loadPins, loadPrimary, loadPref)
+
+ liveActivityManager.updateSessions(receiver.sessions)
+ primarySessionManager.autoSelect(from: receiver.sessions)
+
+ let center = UNUserNotificationCenter.current()
+ try? await center.requestAuthorization(options: [.alert, .sound, .badge])
+ }
+ return true
+ }
+
+ func application(_ application: UIApplication,
+ didReceiveRemoteNotification userInfo: [AnyHashable: Any]
+ ) async -> UIBackgroundFetchResult {
+ // Existing push handling + primarySessionManager.autoSelect(...)
+ }
+}
+```
+
+`CodyncIOSApp` simplified — no `.task` blocks, just passes dependencies to `IOSRootView`.
+
+## File Change Summary
+
+### New Files (6)
+
+| File | Description |
+|---|---|
+| `Codync-iOS/Views/TabRootView.swift` | TabView container |
+| `Codync-iOS/Views/ComingSoonView.swift` | Coming Soon placeholder |
+| `Codync-iOS/Services/PrimarySessionManager.swift` | Primary session logic |
+| `CodyncShared/Sources/Models/OverallAttributes.swift` | Overall Activity data model |
+| `CodyncShared/Sources/Models/SessionSummary.swift` | Session summary model |
+| `CodyncShared/Sources/Models/LiveActivityMode.swift` | Mode enum |
+
+### Modified Files (7)
+
+| File | Changes |
+|---|---|
+| `Codync-iOS/App/AppDelegate.swift` | Consolidate init, add primarySessionManager |
+| `Codync-iOS/App/CodyncIOSApp.swift` | Remove .task blocks, pass new dependencies |
+| `Codync-iOS/Views/IOSRootView.swift` | Show TabRootView post-onboarding |
+| `Codync-iOS/Views/IOSSessionListView.swift` | Mode switcher + primary selection UI |
+| `Codync-iOS/Services/LiveActivityManager.swift` | Dual mode support |
+| `CodyncShared/Sources/CloudKit/CloudKitManager.swift` | Primary + preference methods |
+| `CodyncLiveActivity/CodyncLiveActivityWidget.swift` | Overall mode layout |
+
+### Already Added (Assets)
+
+| Asset | File | Rendering |
+|---|---|---|
+| `ClaudeIcon` | claude.svg | template (follows tint) |
+| `ClaudeColorIcon` | claude-color.svg | original (#D97757) |
+| `CodexIcon` | codex.svg | template (follows tint) |
+| `CodexColorIcon` | codex-color.svg | original (gradient) |
+
+### Unchanged Files
+
+- `IOSSessionDetailView.swift`
+- `IOSStatusIndicator.swift`
+- `IOSTheme.swift`
+- `IOSSessionTagView.swift`
+- `IOSOnboardingView.swift`
+- `CKRecordMapper.swift`
+- `SessionState.swift`, `SessionStatus.swift`, `WaitingReason.swift`, `TaskItem.swift`
+- `CodyncAttributes.swift` (retained for Individual mode)
+
+## Implementation Priority
+
+1. Tab architecture (TabRootView + ComingSoonView + IOSRootView modification)
+2. AppDelegate consolidation (unified init, remove .task blocks)
+3. Data models (OverallAttributes, SessionSummary, LiveActivityMode)
+4. PrimarySessionManager + CloudKit records
+5. LiveActivityManager dual mode
+6. Mode switcher UI in IOSSessionListView
+7. Overall Live Activity widget layout
+8. Primary selection UI (manual lock/unlock)