Files
openagent/ios_dashboard/README.md
Thomas Marchand 3d0b4d19b7 Th0rgal/update branding (#32)
* feat: chroots

* wip

* Update workspace templates and Playwright tests

* Fix thinking panel close button not working during active thinking

The auto-show useEffect was including showThinkingPanel in its dependency
array, causing the panel to immediately reopen when closed since the state
change would trigger the effect while hasActiveThinking was still true.

Changed to use a ref to track previous state and only auto-show on
transition from inactive to active thinking.

* wip

* wip

* wip

* Cleanup web search tool and remove hardcoded OAuth credentials

* Ralph iteration 1: work in progress

* Ralph iteration 2: work in progress

* Ralph iteration 3: work in progress

* Ralph iteration 4: work in progress

* Ralph iteration 5: work in progress

* Ralph iteration 6: work in progress

* Ralph iteration 1: work in progress

* Ralph iteration 2: work in progress

* Ralph iteration 3: work in progress

* Ralph iteration 4: work in progress

* Ralph iteration 5: work in progress

* Ralph iteration 6: work in progress

* Ralph iteration 7: work in progress

* Ralph iteration 1: work in progress

* Ralph iteration 2: work in progress

* improve readme

* fix: remove unused file

* feat: hero screenshot

* Update README with cleaner vision and hero screenshot

Simplified the vision section with "what if" framing, removed
architecture diagram, added hero screenshot showing mission view.
2026-01-12 14:45:05 -08:00

3.5 KiB

Open Agent iOS Dashboard

Native iOS dashboard for Open Agent with Liquid Glass design language.

Features

  • Control - Chat interface with the AI agent, real-time streaming
  • History - View past missions with filtering (active, interrupted, completed, failed)
  • Terminal - Local shell via WebSocket
  • Files - Server file explorer with upload/download

Mission Management

  • Create new missions with optional model override
  • Resume interrupted or blocked missions
  • Mark missions as completed/failed
  • View mission status (active, completed, failed, interrupted, blocked, not_feasible)
  • Model override display per mission

Parallel Missions

  • View all running missions in a compact horizontal bar
  • Switch between parallel missions with a single tap
  • Real-time status indicators (running, stalled, severely stalled)
  • Cancel running missions directly from the bar
  • Automatic polling for running mission updates (every 3s)
  • SSE event filtering by mission_id to prevent cross-contamination

Design System

Built with "Quiet Luxury + Liquid Glass" aesthetic:

  • Dark-first design (#121214 deep charcoal backgrounds)
  • Glass morphism with .ultraThinMaterial and .thinMaterial
  • Indigo accent color (#6366F1)
  • Subtle borders (0.06-0.08 opacity)
  • Smooth animations (150-200ms, ease-out)

Requirements

  • iOS 18.0+
  • Xcode 16.0+
  • Swift 6.0

Building

Using XcodeGen

# Install xcodegen if needed
brew install xcodegen

# Generate project
cd ios_dashboard
xcodegen generate

# Open in Xcode
open OpenAgentDashboard.xcodeproj

Command Line Build

xcodebuild -project OpenAgentDashboard.xcodeproj \
  -scheme OpenAgentDashboard \
  -destination 'platform=iOS Simulator,name=iPhone 17' \
  build

Configuration

The app connects to the Open Agent backend. Configure the server URL:

  • Default: https://agent-backend.thomas.md
  • Can be changed in the login screen

In multi-user mode, the login screen also asks for a username.

Project Structure

ios_dashboard/
├── project.yml                 # XcodeGen config
├── OpenAgentDashboard/
│   ├── OpenAgentDashboardApp.swift
│   ├── ContentView.swift       # Auth + Tab navigation
│   ├── DesignSystem/
│   │   └── Theme.swift         # Colors, typography, haptics
│   ├── Models/
│   │   ├── Mission.swift
│   │   ├── ChatMessage.swift
│   │   └── FileEntry.swift
│   ├── Services/
│   │   └── APIService.swift    # HTTP + SSE client
│   ├── Views/
│   │   ├── Control/            # Chat interface
│   │   ├── History/            # Mission history
│   │   ├── Terminal/           # Local shell
│   │   ├── Files/              # File explorer
│   │   └── Components/         # Reusable UI
│   │       ├── GlassButton.swift
│   │       ├── GlassCard.swift
│   │       ├── StatusBadge.swift
│   │       ├── LoadingView.swift
│   │       ├── RunningMissionsBar.swift   # Parallel missions UI
│   │       └── ToolUI/         # Tool UI components
│   └── Assets.xcassets/
└── OpenAgentDashboard.xcodeproj/

Glass Components

GlassCard

GlassCard {
    Text("Content with glass background")
}

GlassButton

GlassPrimaryButton("Send", icon: "paperplane.fill") {
    // action
}

GlassIconButton(icon: "plus", action: { })

StatusBadge

StatusBadge(status: .running)
StatusDot(status: .connected)