📱 Mobile App

Your local agent in your pocket. Extend your desktop’s power with native mobile extensions, offering secure on-device automation and voice interactions on the go.

The CI Connect mobile app is currently in closed preview. Request early access from the Companion Intelligence team.

Overview

CI Connect (the Companion Intelligence mobile app) is a native iOS and Android application that keeps your mobile device in sync with your Hub. It functions as both a remote interface to your local server and an on-device agent, capable of running automations, responding to voice commands, and capturing context — all while routing data back to your Hub rather than any cloud.

The app uses zero-trust connectivity via the Portal layer to establish a secure, end-to-end encrypted connection to your Hub from anywhere in the world, without exposing your server to the open internet.

Key Features

Hub remote control — manage apps, view status, and trigger actions from your phone
Agent conversations — chat with your Companion Agents using full memory context
Voice interactions — on-device voice command capture with transcription routed to your local LLM
File access — browse, upload, and download files from your Hub’s storage
Push notifications — receive alerts from Uptime Kuma, Home Assistant, and other Hub apps
Wearable relay — acts as a data bridge for Bluetooth wearables (Omi, Pebble) to your Hub
Offline mode — queues commands and media captures for delivery when connectivity is restored
Biometric authentication — Face ID / fingerprint for secure Hub access on mobile

Supported Platforms

Platform	Status
iOS 16+ (iPhone & iPad)	🔄 Closed Preview
Android 12+	🔄 Closed Preview

Use Cases

Use your phone as a microphone and speaker for your local voice agent while away from your desk
Receive push alerts from your Hub (server down, new media, Home Assistant events) on your phone
Browse your Digital Memory and ask questions to your agent while commuting
Capture photos or voice notes that immediately flow into your local Digital Memory
Control Hub apps (start/stop containers, run automations) without opening a laptop

Architecture


Mobile Device
├── CI Connect App
│   ├── Voice Capture (on-device STT)
│   ├── Camera / Media Capture
│   ├── Wearable BLE Relay
│   └── Hub API Client
│             │
│             │  end-to-end encrypted
│             │  (Portal zero-trust tunnel)
│             ▼
         Companion Portal
              │
              ▼
         Companion Hub
              ├── Digital Memory Server
              ├── Companion Agents
              └── App Services

When on the same local network as your Hub, CI Connect communicates directly over LAN. When remote, traffic is routed through the Portal tunnel with no data touching Companion Intelligence infrastructure.

Setup

Enable Portal remote access

Before setting up the mobile app, ensure your Hub’s Portal is configured for remote access. See the Portal documentation for setup instructions.

Install CI Connect

Once your preview access is approved, you will receive a TestFlight (iOS) or APK download (Android) link. Install the app from there.

Add your Hub

Open CI Connect → Add Hub
Scan the QR code in Hub → Settings → Mobile → Pair Device, or enter your Portal connection URL manually
Authenticate with your Hub credentials

Configure notifications

In the app under Settings → Notifications, choose which Hub apps can send push alerts to your device.

Usage

Voice Agent

Tap the microphone button on the home screen to start a voice interaction. Your speech is transcribed on-device (no cloud STT), then sent to your local LLM agent along with relevant Digital Memory context.

Media Capture

Tap Capture to take a photo or record audio. Both are immediately uploaded to your Hub and ingested into Digital Memory.

Hub Dashboard

The Dashboard tab mirrors your Hub’s app grid, letting you open web UIs in the in-app browser or trigger quick actions (restart app, clear cache).

File Browser

Navigate to Files to browse your synced folder tree. Tap any file to preview or download it to your device.

Troubleshooting

Cannot connect to Hub from outside home network Verify the Portal is running and your remote access configuration is active. Check Hub → Portal → Status. See Portal troubleshooting for detailed diagnostics.

Voice recognition is inaccurate On-device STT quality depends on your device’s on-board model. In Settings → Voice, switch the transcription backend to your local Hub’s Whisper instance for higher accuracy at the cost of a small network round trip.

Push notifications not arriving Check Settings → Notifications on your device and ensure CI Connect has notification permission. Verify your Hub’s notification service is running under Hub → Settings → Notifications.

App crashes on launch Ensure you are running a supported OS version (iOS 16+ or Android 12+). Force-quit and relaunch. If the issue persists, re-pair your Hub connection.