How jaskran0417/ai-termux-wadb-toolkit works
AI Termux WADB Toolkit is an Android-side control and setup layer that lets a compatible AI client work in an authorized Termux environment through Desktop Commander Remote MCP. The documented flow is to establish that connection, use Toolkit controls to inspect or configure phone connectivity and permissions, then run Termux commands and verify state. The graph preserves the separate local shells, Wireless ADB, Bridge recovery, and integrity capabilities. Most scripts were not sampled, so their internal call relationships are not inferred.
Main entry points: ai-info Control Center · McpRecoveryReceiver.java Recovery Receiver · wadb-mcp-recovery-setup Recovery Setup · RecoveryControlReceiver.java Recovery Alarm Control
Components 23
AI Access
- Desktop Commander
Phone Connectivity
- Wireless ADB Controls
scripts/wireless-debug-on - ADB Discovery
scripts/adb-mdns-discover - ADB Connection
scripts/wireless-adb-connect - WADB Bridge
bridge-source/app/src/main/java/com/jaskran/wadbbridge/WirelessDebugReceiver.java
Shells and MCP
- Termux Environment
- Local Termux Shell
native/wadb-local-bridge.c - Local Android Shell
scripts/wadb-local-on - MCP Lifecycle
scripts/wadb-mcp-start - GitHub Controls
scripts/wadb-mcp-github-sync
Bridge Recovery
- Recovery Setup
scripts/wadb-mcp-recovery-setup - Recovery Alarm Control
bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java - Recovery Receiver
bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java - Permission Screen
bridge-source/app/src/main/java/com/jaskran/wadbbridge/PermissionActivity.java - MCP Watchdog
scripts/wadb-mcp-watchdog
Security and Status
- Control Center
scripts/ai-info - Installed Integrity
security/verify-installed.js - Release Verification
security/verify-release.js - Install Preflight
security/install-path-preflight.js - Phone Capabilities
scripts/phone-capabilities - Toolkit Notifications
scripts/wadb-notify
Other components
- Phone Owner
- AI Assistant
Connections 22
- Phone Owner → AI Assistant: requests setup
README.md - AI Assistant → Desktop Commander: uses connection
README.md - Desktop Commander → Termux Environment: accesses tools
README.md - AI Assistant → Control Center: runs commands
README.md - Control Center → Wireless ADB Controls: manages Wi-Fi ADB
README.md - Control Center → ADB Discovery: discovers devices
README.md - Control Center → ADB Connection: connects ADB
README.md - Control Center → WADB Bridge: manages Bridge
README.md - AI Assistant → Local Termux Shell: uses local shell
README.md - AI Assistant → Local Android Shell: uses local shell
README.md - Control Center → MCP Lifecycle: manages lifecycle
README.md - Control Center → GitHub Controls: configures integration
README.md - Control Center → Recovery Setup: configures recovery
README.md - Recovery Alarm Control → Recovery Receiver: schedules or cancels
bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java - Recovery Receiver → Termux Environment: starts recovery job
bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java - Control Center → MCP Watchdog: manages watchdog
README.md - Control Center → Installed Integrity: checks installation
README.md - Phone Owner → Release Verification: verifies release
README.md - Control Center → Install Preflight: preflights install
README.md - Control Center → Phone Capabilities: reports capabilities
README.md - Recovery Receiver → Toolkit Notifications: reports recovery state
README.md - Recovery Setup → Permission Screen: opens permission screen
README.md