feat: Add app installation functionality and documentation for CLI and desktop app

Author: himanshkukreja

.github/workflows/build-and-release.yml

@@ -9,7 +9,7 @@ on:
       version:
         description: 'Release version (e.g., v1.0.0)'
         required: true
-        default: 'v1.0.9'
+        default: 'v1.0.10'
 
 permissions:
   contents: write

ios-bridge-cli/README.md

@@ -91,6 +91,27 @@ ios-bridge info <session-id>
 ios-bridge terminate <session-id>
 ```
 
+### App Installation
+```bash
+# Install iOS app (.ipa or .zip) on simulator
+ios-bridge install-app /path/to/MyApp.ipa
+
+# Install and launch immediately (shows upload progress)
+ios-bridge install-app /path/to/MyApp.ipa --launch
+
+# Install on specific session (auto-detects if only one session)
+ios-bridge install-app /path/to/MyApp.zip <session-id> --launch
+
+# Skip confirmation prompt with visual progress
+ios-bridge install-app /path/to/MyApp.ipa --force
+```
+
+**Features:**
+- 📊 **Visual Progress Bar**: Real-time upload progress indicator
+- ⚙️ **Installation Status**: Clear feedback during processing
+- 🎯 **File Size Display**: Shows file size before upload
+- 🚀 **Launch Integration**: Automatic app launching after installation
+
 ### Streaming & Control
 ```bash
 # Stream session (auto-detects if only one session)

ios-bridge-cli/USAGE.md

@@ -86,6 +86,73 @@ ios-bridge screenshot a1b2c3d4e5f6 --output ~/Desktop/ios-screenshot.png
 ios-bridge screenshot a1b2c3d4e5f6 --server http://localhost:8000 --output device.png
 ```
 
+### 5. App Installation
+
+Install iOS apps (.ipa files) or app bundles (.zip files) directly onto simulator sessions:
+
+```bash
+# Install app on auto-detected session (if only one exists)
+ios-bridge install-app /path/to/MyApp.ipa
+
+# Install and launch immediately  
+ios-bridge install-app /path/to/MyApp.ipa --launch
+
+# Install on specific session
+ios-bridge install-app /path/to/MyApp.ipa a1b2c3d4e5f6
+
+# Install app bundle from ZIP file
+ios-bridge install-app /path/to/MyAppBundle.zip --launch
+
+# Skip confirmation prompts (useful for automation)
+ios-bridge install-app /path/to/MyApp.ipa --force --launch
+
+# With custom server
+ios-bridge install-app /path/to/MyApp.ipa --server http://localhost:8000 --launch
+```
+
+Example output:
+```
+📱 Installing app on iOS simulator:
+   App: MyApp.ipa (15.2 MB)
+   Device: iPhone 14 Pro iOS 16.0
+   Session: a1b2c3d4e5f6...
+   Action: Install and launch
+
+💡 Do you want to install and launch MyApp.ipa? [y/N]: y
+
+🚀 Installing and launching MyApp.ipa...
+📤 Uploading MyApp.ipa  [████████████████████████████████] 100%
+⚙️  Processing installation...
+✅ App installed and launched successfully!
+
+📋 App Details:
+   Name: My Awesome App
+   Bundle ID: com.company.myapp
+   Version: 1.0.0
+
+🚀 App launched:
+   Bundle ID: com.company.myapp
+   Process ID: 12345
+```
+
+**Progress Features:**
+- **Upload Progress Bar**: Visual progress indicator showing upload status
+- **File Size Display**: Shows file size in MB before upload
+- **Installation Phases**: Clear indicators for upload and installation phases
+- **Real-time Updates**: Progress bar updates smoothly during upload
+
+**Supported formats:**
+- `.ipa` files (iOS app archives)
+- `.zip` files (containing `.app` bundles)
+
+**Error handling:**
+The command provides detailed error messages for common issues:
+- File not found or unreadable
+- Unsupported file format
+- Session not found
+- Installation failures with specific error codes
+- Network connection issues
+
 ## Desktop Controls
 
 Once the desktop window opens, you can use these controls:
@@ -156,6 +223,19 @@ Create `~/.ios-bridge-cli.json`:
 for session in $(ios-bridge list --format json | jq -r '.[].session_id'); do
     ios-bridge stream "$session" &
 done
+
+# Install app on all active sessions
+for session in $(ios-bridge list --format json | jq -r '.[].session_id'); do
+    echo "Installing app on session $session"
+    ios-bridge install-app /path/to/MyApp.ipa "$session" --force --launch
+done
+
+# Automated testing workflow
+SESSION_ID=$(ios-bridge create "iPhone 14 Pro" "16.0" --wait | grep "Session ID:" | awk '{print $3}')
+ios-bridge install-app /path/to/TestApp.ipa "$SESSION_ID" --force --launch
+sleep 5  # Wait for app to fully launch
+ios-bridge screenshot "$SESSION_ID" --output test-result.png
+ios-bridge terminate "$SESSION_ID" --force
 ```
 
 ### Scripting Integration
@@ -164,6 +244,7 @@ done
 #!/usr/bin/env python3
 import subprocess
 import json
+import sys
 
 # Get list of sessions
 result = subprocess.run([
@@ -172,12 +253,26 @@ result = subprocess.run([
 
 sessions = json.loads(result.stdout)
 
-# Stream the first available session
-if sessions:
-    session_id = sessions[0]['session_id']
+if not sessions:
+    print("No sessions available")
+    sys.exit(1)
+
+# Install app on first available session
+session_id = sessions[0]['session_id']
+app_path = "/path/to/MyApp.ipa"
+
+print(f"Installing app on session: {session_id}")
+install_result = subprocess.run([
+    'ios-bridge', 'install-app', app_path, session_id, '--launch', '--force'
+], capture_output=True, text=True)
+
+if install_result.returncode == 0:
+    print("✅ App installed successfully")
+    # Stream the session
     subprocess.run(['ios-bridge', 'stream', session_id])
 else:
-    print("No sessions available")
+    print(f"❌ App installation failed: {install_result.stderr}")
+    sys.exit(1)
 ```
 
 ## Integration Examples

ios-bridge-cli/ios_bridge_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ios-bridge-cli
-Version: 1.0.6
+Version: 1.0.9
 Summary: Desktop streaming client for iOS Bridge simulator sessions with Electron app integration
 Home-page: https://github.com/AutoFlowLabs/ios-bridge-cli
 Author: iOS Bridge Team
@@ -33,6 +33,16 @@ Requires-Dist: pillow>=8.0.0
 Requires-Dist: psutil>=5.8.0
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: packaging>=21.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: starlette>=0.27.0
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: opencv-python>=4.5.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: av>=10.0.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: aiortc>=1.6.0
 Provides-Extra: dev
 Requires-Dist: pytest>=6.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
@@ -41,6 +51,8 @@ Requires-Dist: flake8>=4.0; extra == "dev"
 Requires-Dist: mypy>=0.900; extra == "dev"
 Requires-Dist: build>=0.8.0; extra == "dev"
 Requires-Dist: twine>=4.0.0; extra == "dev"
+Provides-Extra: server
+Requires-Dist: fb-idb>=1.1.0; extra == "server"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -139,6 +151,27 @@ ios-bridge info <session-id>
 ios-bridge terminate <session-id>
 ```
 
+### App Installation
+```bash
+# Install iOS app (.ipa or .zip) on simulator
+ios-bridge install-app /path/to/MyApp.ipa
+
+# Install and launch immediately (shows upload progress)
+ios-bridge install-app /path/to/MyApp.ipa --launch
+
+# Install on specific session (auto-detects if only one session)
+ios-bridge install-app /path/to/MyApp.zip <session-id> --launch
+
+# Skip confirmation prompt with visual progress
+ios-bridge install-app /path/to/MyApp.ipa --force
+```
+
+**Features:**
+- 📊 **Visual Progress Bar**: Real-time upload progress indicator
+- ⚙️ **Installation Status**: Clear feedback during processing
+- 🎯 **File Size Display**: Shows file size before upload
+- 🚀 **Launch Integration**: Automatic app launching after installation
+
 ### Streaming & Control
 ```bash
 # Stream session (auto-detects if only one session)

ios-bridge-cli/ios_bridge_cli.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ requirements.txt
 setup.py
 test_package.py
 ios_bridge_cli/__init__.py
+ios_bridge_cli/__main__.py
 ios_bridge_cli/app_manager.py
 ios_bridge_cli/cli.py
 ios_bridge_cli/client.py

ios-bridge-cli/ios_bridge_cli.egg-info/requires.txt

@@ -9,6 +9,12 @@ fastapi>=0.100.0
 uvicorn>=0.23.0
 pydantic>=2.0.0
 starlette>=0.27.0
+python-multipart>=0.0.6
+opencv-python>=4.5.0
+numpy>=1.21.0
+av>=10.0.0
+jinja2>=3.0.0
+aiortc>=1.6.0
 
 [dev]
 pytest>=6.0

ios-bridge-cli/ios_bridge_cli/__init__.py

@@ -2,5 +2,5 @@
 iOS Bridge CLI - Desktop streaming client for iOS Bridge simulator sessions
 """
 
-__version__ = "1.0.9"
+__version__ = "1.0.10"
 __author__ = "iOS Bridge Team"

ios-bridge-cli/ios_bridge_cli/__main__.py

@@ -0,0 +1,9 @@
+"""
+Main entry point for ios_bridge_cli package when run as a module.
+This allows the package to be executed with: python -m ios_bridge_cli
+"""
+
+from .cli import main
+
+if __name__ == '__main__':
+    main()