How qw-ai-code/aether works
Aether Mobile is an Android VPN client built around an in-app tunnelling engine. The primary workflow is selecting a saved profile, obtaining Android VPN consent when needed, starting the service and engine, and exposing connection state to the user. Other product branches include routing and transport choices, LAN tunnel sharing, AI assistance, team/zero-trust access, and diagnostics. The excerpts show only selected wiring; unsampled subsystem links are omitted or marked unverified rather than treated as inspected.
Main entry points: MainActivity.kt Main activity · AetherVpnService.kt VPN service · AetherController.kt Connection controller · ShareBridge.kt Share bridge
Components 23
Android app
- Main activity
app/src/main/java/studio/cluvex/aether/MainActivity.kt - Home screen
app/src/main/java/studio/cluvex/aether/ui/HomeScreen.kt - Profile store
app/src/main/java/studio/cluvex/aether/data/ProfileStore.kt - Connection state
app/src/main/java/studio/cluvex/aether/model/ConnectionState.kt - Connection controller
app/src/main/java/studio/cluvex/aether/core/AetherController.kt - Diagnostics log
app/src/main/java/studio/cluvex/aether/core/DiagnosticsLog.kt
Tunnel runtime
- VPN service
app/src/main/java/studio/cluvex/aether/vpn/AetherVpnService.kt - Engine process
app/src/main/java/studio/cluvex/aether/core/AetherProcess.kt - Tunnel configuration
app/src/main/java/studio/cluvex/aether/core/TunnelConfig.kt - Routing engine
app/src/main/java/studio/cluvex/aether/core/RoutingEngine.kt - Aether native engine
native/aether/aether/src/lib.rs - Transport backends
app/src/main/java/studio/cluvex/aether/transport/ExternalTransport.kt
LAN sharing
- Share bridge
app/src/main/java/studio/cluvex/aether/core/ShareBridge.kt - Share pages
app/src/main/java/studio/cluvex/aether/core/SharePages.kt - Share leak guard
app/src/main/java/studio/cluvex/aether/core/ShareLeakGuard.kt
AI assistance
- AI session
app/src/main/java/studio/cluvex/aether/ai/AiSession.kt - Gemini client
app/src/main/java/studio/cluvex/aether/ai/GeminiClient.kt
Identity and access
- Team and zero-trust
app/src/main/java/studio/cluvex/aether/core/ZeroTrustSignIn.kt - Membership settings
app/src/main/java/studio/cluvex/aether/ui/settings/ZeroTrustMembership.kt
Other components
- User
- LAN client
- Gemini API
- Android VPN consent
Connections 19
- User → Main activity: opens app
app/src/main/java/studio/cluvex/aether/MainActivity.kt - Main activity → Home screen: renders
app/src/main/java/studio/cluvex/aether/MainActivity.kt - Main activity → Profile store: loads profile
app/src/main/java/studio/cluvex/aether/MainActivity.kt - Main activity → Connection controller: starts connection
app/src/main/java/studio/cluvex/aether/MainActivity.kt - Main activity → Android VPN consent: requests consent
app/src/main/java/studio/cluvex/aether/MainActivity.kt - Connection controller → VPN service: starts service
app/src/main/java/studio/cluvex/aether/core/AetherController.kt - Connection controller → Connection state: publishes state
app/src/main/java/studio/cluvex/aether/core/AetherController.kt - VPN service → Engine process: launches engine
app/src/main/java/studio/cluvex/aether/vpn/AetherVpnService.kt - VPN service → Connection state: updates state
app/src/main/java/studio/cluvex/aether/vpn/AetherVpnService.kt - VPN service → Diagnostics log: records events
app/src/main/java/studio/cluvex/aether/vpn/AetherVpnService.kt - Engine process → Aether native engine: loads native engine
- VPN service → Share bridge: starts sharing
app/src/main/java/studio/cluvex/aether/vpn/AetherVpnService.kt - Share bridge → Share pages: serves pages
- Share bridge → Share leak guard: protects traffic
- LAN client → Share pages: opens setup
- AI session → Gemini client: requests generation
app/src/main/java/studio/cluvex/aether/ai/AiSession.kt - Gemini client → Gemini API: sends request
- Gemini client → Diagnostics log: uses diagnostics
app/src/main/java/studio/cluvex/aether/ai/GeminiClient.kt - Membership settings → Team and zero-trust: manages access