multica/apps/ios

Multica iOS App

MVP iOS client for the Multica platform — issue management with AI agent execution log viewing.

Requirements

• Xcode 16+
• iOS 17.0+
• XcodeGen (for generating the Xcode project)

Setup

# Install XcodeGen if you don't have it
brew install xcodegen

# Generate Xcode project
cd apps/ios
xcodegen generate

# Open in Xcode
open Multica.xcodeproj

Configuration

By default, the app connects to http://localhost:8080 in debug builds. To change the API URL, edit Multica/Services/APIClient.swift.

Features

• Authentication — Passwordless email login (send code → verify)
• Workspace selection — Pick from your workspaces
• Issue list — Grouped by status, searchable, with status filtering
• Issue detail — View/edit title, status, priority, and assignee
• Comments — View and add comments with threaded display
• Agent task runs — View all historical agent executions for an issue
• Execution logs — Real-time streaming of agent tool use, thinking, and output
• Real-time sync — WebSocket connection for live updates

Architecture

• SwiftUI with @Observable (iOS 17+)
• MVVM — ViewModels use @Observable macro
• URLSession for HTTP networking
• URLSessionWebSocketTask for real-time
• Keychain for secure token storage
• No third-party dependencies

Structure

Multica/
├── MulticaApp.swift          # App entry point
├── Models/                   # Codable data models
├── Services/                 # API client, WebSocket, Keychain
├── ViewModels/               # @Observable view models
└── Views/
    ├── Auth/                 # Login + code verification
    ├── Workspace/            # Workspace picker
    ├── Issues/               # List, detail, create
    ├── Comments/             # Comment list + input
    ├── Tasks/                # Agent runs + execution logs
    └── Components/           # Shared UI (badges, icons, avatars)