Skip to content

Getting Started with CAI Mobile UI

⚡ CAI-Pro Exclusive
Join the TestFlight Beta to get started with CAI Mobile UI.

This guide will walk you through installing, configuring, and using the CAI Mobile UI for the first time.

Prerequisites

Before you begin, ensure you have:

  1. CAI-Pro License: Active subscription from Alias Robotics
  2. iOS Device: iPhone or iPad running iOS 15.0+
  3. CAI API Server: Running CAI API server (v0.7.0+) on your network
  4. API Key: Valid ALIAS_API_KEY for authentication

Installation

Step 1: Join TestFlight Beta

  1. On your iOS device, visit: https://testflight.apple.com/join/nXZZD4Z5
  2. If prompted, install TestFlight from the App Store
  3. Accept the beta testing invitation
  4. Tap "Install" to download CAI Mobile UI

Step 2: Launch the App

  1. Find the CAI app icon on your home screen
  2. Tap to launch
  3. Grant necessary permissions when prompted:
  4. Local Network: Required for discovering CAI servers
  5. Notifications: Optional, for background task alerts

CAI Mobile UI Login Screen

Initial Setup

Option A: Automatic Server Discovery

Perfect for local network setups:

  1. Start your CAI API server on your computer: 

    cai --api
    Note the server address (e.g., http://192.168.1.100:8000)

  2. On your iOS device:

  3. Ensure Wi-Fi is enabled and connected to the same network
  4. Tap "Scan Network" on the login screen
  5. Wait for the discovery process (usually 2-3 seconds)

  6. Select your server from the list

  7. Enter your API key:

  8. Paste or type your ALIAS_API_KEY
  9. Toggle "Remember Me" to save credentials
  10. Tap "Connect"

Option B: Manual Server Configuration

For remote servers or specific configurations:

  1. Server URL:
  2. Enter the complete URL (e.g., https://cai.company.com:8443)
  3. Include the protocol (http:// or https://)

  4. Include the port if not standard

  5. API Key:

  6. Enter your ALIAS_API_KEY

  7. Toggle "Remember Me" for convenience

  8. Advanced Options (tap gear icon):

  9. Timeout: Adjust connection timeout (default: 30s)
  10. SSL Verification: Toggle for self-signed certificates

  11. Proxy: Configure if needed

  12. Tap "Connect"

First Session

1. Welcome Screen

After successful connection, you'll see: - Agent selector at the top - Model selector below - Empty chat interface - Navigation tabs at bottom

2. Select an Agent

For your first session, we recommend:

  1. Tap the agent selector
  2. Choose selection_agent - it helps recommend the right agent for your task
  3. Or select a specific agent like:
  4. red_teamer_agent - For offensive security testing
  5. blue_teamer_agent - For defensive analysis
  6. bug_hunter_agent - For vulnerability discovery

3. Choose a Model

  1. Tap the model dropdown
  2. Recommended models:
  3. gpt-4o - Best overall performance
  4. claude-3.5-sonnet - Excellent for code analysis
  5. alias1 - Optimized for security tasks
  6. cohere/command-r-plus-08-2024 - Great performance and value

4. Start Your First Conversation

CAI Mobile UI Chat Interface

Try these starter prompts:

For Security Testing: 

Analyze the security of example.com

For Learning: 

Explain how SQL injection works and how to prevent it

For Agent Recommendation: 

I need to perform a penetration test on a web application. Which agent should I use?

5. Understanding Responses

As the agent responds, you'll see:

  • Streaming Text: Responses appear in real-time
  • Formatted Output: Code blocks, lists, and emphasis
  • Thinking Indicators: When agents are processing
  • Tool Usage: When agents use external tools

CAI Mobile UI Reasoning Display

Essential Features

Message Interactions

  • Copy Text: Long press any message → Copy
  • Share Output: Long press → Share → Choose app
  • Save Code: Tap code blocks → Copy button
  • Retry Message: Swipe left on your message → Retry
  • Switch Conversations: Swipe left/right or use tab bar
  • New Conversation: Tap + button
  • View History: Tap clock icon
  • Return Home: Tap CAI logo

Quick Actions

  • Cancel Generation: Pull down while response is streaming
  • Clear Chat: Shake device → Clear option
  • Change Agent Mid-Chat: Tap agent name → Select new
  • Export Session: Menu → Export → Choose format

Keyboard Shortcuts (iPad with External Keyboard)

Shortcut Action
⌘ + N New conversation
⌘ + W Close current chat
⌘ + ←/→ Switch conversations
⌘ + K Quick agent switch
⌘ + / Focus message input
⌘ + ↑ Previous message

Best Practices

1. Network Connection

  • Use Wi-Fi when possible for better performance
  • Enable "Low Data Mode" in settings for cellular
  • Download conversations for offline viewing

2. Security

  • Enable Face ID/Touch ID in settings
  • Don't share screenshots with API keys visible
  • Use secure connections (HTTPS) when possible

3. Performance

  • Close unused conversations to free memory
  • Enable "Reduce Motion" for older devices
  • Clear cache periodically in settings

Troubleshooting

Common Issues

Can't connect to server: - Verify server is running: cai --api - Check firewall allows port 8000 - Ensure devices are on same network - Try manual IP instead of discovery

Authentication failed: - Regenerate API key: cai --keys - Check key hasn't expired - Verify key matches server configuration

App crashes or freezes: - Force quit and restart app - Check for app updates in TestFlight - Clear app cache in settings - Report issue with crash logs

Getting Help

  1. In-App Help: Tap menu → Help
  2. Documentation: https://docs.aliasrobotics.com
  3. Discord Community: Join Discord
  4. Report Issues: GitHub Issues

Next Steps

Now that you're connected and running:

  1. 📱 Explore the User Interface
  2. 👆 Master Gestures & Shortcuts
  3. 💬 Learn Advanced Chat Features
  4. 🛠️ Configure Network & MCP Tools

Welcome to CAI Mobile UI - Security testing in your pocket!