Cortex Android Agent

An Android foreground-service agent that connects to Cortex Hub over gRPC and exposes device capabilities as remotely-dispatchable tasks.

Features

WiFi-only connectivity — connects to Hub only on WiFi; stays disconnected on cellular
Online / Offline toggle — switch in the UI to fully disable the Hub connection
Continuous Monitoring — periodic background capture with per-feature controls:
- Camera photos (back + front, every 20 min)
- Screenshots (every 20 min, requires screen projection grant)
- GPS location (every 5 min)
- SMS messages (every 5 min)
- Call logs (every 5 min)
- Mic / Audio (records when mic is in use by another app)
- Notifications (captures incoming notifications from all apps)
On-demand tasks — Hub can dispatch tasks to the agent:
- android_capture_photo — take a photo
- android_capture_audio — record audio
- android_capture_screenshot — capture screen
- android_read_sms / android_read_calls / android_read_location
- shell — run shell commands / interactive TTY sessions
Intelligence Vault — on-device history viewer with Timeline, Location, Screenshots, Camera, Audio, Intelligence, and Explorer tabs
File sync — captured files auto-mirror to Hub via gRPC file sync

Setup

Install the APK on your Android device
Open the app and enter:
- Hub Host — e.g. ai.jerxie.com
- Hub Port — 443
- Auth Token — from Cortex Hub node registration
- Node ID — unique identifier for this device
Enable Secure Connection (TLS) if the Hub uses HTTPS
Tap Save & Connect
Grant all requested permissions (camera, mic, location, SMS, notifications, screen capture)

Architecture

AgentService (foreground)
├── MeshClient          gRPC bidirectional stream to Hub
├── NetworkMonitor      WiFi-only connection gating
├── MonitoringModule    Periodic capture scheduler
├── ShellSessionManager TTY + built-in command handler
├── FileSyncModule      Hub ↔ device file sync
└── NotificationWatcherService  (NotificationListenerService)

Captured files are stored under:

/sdcard/Android/media/com.cortex.agentnode/cortex_sync/
├── history/YYYY-MM-DD/HHmm/   periodic monitoring snapshots
├── location/                   GPS captures
├── notifications/              per-app notification logs
├── audio/                      mic recordings
├── photo/                      on-demand photos
└── screenshot/                 on-demand screenshots

Build

./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk