# jaskran0417/ai-termux-wadb-toolkit architecture

> Architecture diagram of the GitHub repository jaskran0417/ai-termux-wadb-toolkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jaskran0417/ai-termux-wadb-toolkit
- Repository: https://github.com/jaskran0417/ai-termux-wadb-toolkit

## Overview

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: [`scripts/ai-info`](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/ai-info) (Control Center), [`bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java`](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java) (Recovery Receiver), [`scripts/wadb-mcp-recovery-setup`](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-recovery-setup) (Recovery Setup), [`bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java`](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java) (Recovery Alarm Control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["AI Access"]
  node_desktop["Desktop Commander"]
end

subgraph group_connectivity["Phone Connectivity"]
  node_wireless["Wireless ADB Controls"]
  node_discovery["ADB Discovery"]
  node_adbconnect["ADB Connection"]
  node_bridge["WADB Bridge"]
end

subgraph group_runtime["Shells and MCP"]
  node_termux["Termux Environment"]
  node_termuxshell["Local Termux Shell"]
  node_androidshell["Local Android Shell"]
  node_mcp["MCP Lifecycle"]
  node_github["GitHub Controls"]
end

subgraph group_recovery["Bridge Recovery"]
  node_recoverysetup["Recovery Setup"]
  node_recoverycontrol["Recovery Alarm Control"]
  node_recoveryreceiver["Recovery Receiver"]
  node_permissions["Permission Screen"]
  node_watchdog["MCP Watchdog"]
end

subgraph group_assurance["Security and Status"]
  node_control["Control Center"]
  node_integrity["Installed Integrity"]
  node_releaseverify["Release Verification<br/>[verify-release.js]"]
  node_preflight["Install Preflight"]
  node_capabilities["Phone Capabilities"]
  node_notifications["Toolkit Notifications"]
end

node_owner(("Phone Owner"))
node_assistant(("AI Assistant"))

node_owner -->|"requests setup"| node_assistant
node_assistant -->|"uses connection"| node_desktop
node_desktop -->|"accesses tools"| node_termux
node_assistant -->|"runs commands"| node_control
node_control -->|"manages Wi-Fi ADB"| node_wireless
node_control -->|"discovers devices"| node_discovery
node_control -->|"connects ADB"| node_adbconnect
node_control -->|"manages Bridge"| node_bridge
node_assistant -->|"uses local shell"| node_termuxshell
node_assistant -->|"uses local shell"| node_androidshell
node_control -->|"manages lifecycle"| node_mcp
node_control -->|"configures integration"| node_github
node_control -->|"configures recovery"| node_recoverysetup
node_recoverycontrol -->|"schedules or cancels"| node_recoveryreceiver
node_recoveryreceiver -->|"starts recovery job"| node_termux
node_control -->|"manages watchdog"| node_watchdog
node_control -->|"checks installation"| node_integrity
node_owner -->|"verifies release"| node_releaseverify
node_control -->|"preflights install"| node_preflight
node_control -->|"reports capabilities"| node_capabilities
node_recoveryreceiver -->|"reports recovery state"| node_notifications
node_recoverysetup -->|"opens permission screen"| node_permissions

click node_control "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/ai-info"
click node_wireless "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wireless-debug-on"
click node_discovery "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/adb-mdns-discover"
click node_adbconnect "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wireless-adb-connect"
click node_bridge "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/WirelessDebugReceiver.java"
click node_termuxshell "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/native/wadb-local-bridge.c"
click node_androidshell "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-local-on"
click node_mcp "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-start"
click node_github "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-github-sync"
click node_recoverysetup "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-recovery-setup"
click node_recoverycontrol "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java"
click node_recoveryreceiver "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java"
click node_permissions "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/PermissionActivity.java"
click node_watchdog "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-watchdog"
click node_integrity "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/security/verify-installed.js"
click node_releaseverify "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/security/verify-release.js"
click node_preflight "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/security/install-path-preflight.js"
click node_capabilities "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/phone-capabilities"
click node_notifications "https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-notify"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_desktop toneBlue
class node_wireless,node_discovery,node_adbconnect,node_bridge toneAmber
class node_termux,node_termuxshell,node_androidshell,node_mcp,node_github toneMint
class node_recoverysetup,node_recoverycontrol,node_recoveryreceiver,node_permissions,node_watchdog toneRose
class node_control,node_integrity,node_releaseverify,node_preflight,node_capabilities,node_notifications,node_owner,node_assistant toneIndigo
```

## Components

### AI Access

- **Desktop Commander**

### Phone Connectivity

- [Wireless ADB Controls](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wireless-debug-on): `scripts/wireless-debug-on`
- [ADB Discovery](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/adb-mdns-discover): `scripts/adb-mdns-discover`
- [ADB Connection](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wireless-adb-connect): `scripts/wireless-adb-connect`
- [WADB Bridge](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/WirelessDebugReceiver.java): `bridge-source/app/src/main/java/com/jaskran/wadbbridge/WirelessDebugReceiver.java`

### Shells and MCP

- **Termux Environment**
- [Local Termux Shell](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/native/wadb-local-bridge.c): `native/wadb-local-bridge.c`
- [Local Android Shell](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-local-on): `scripts/wadb-local-on`
- [MCP Lifecycle](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-start): `scripts/wadb-mcp-start`
- [GitHub Controls](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-github-sync): `scripts/wadb-mcp-github-sync`

### Bridge Recovery

- [Recovery Setup](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-recovery-setup): `scripts/wadb-mcp-recovery-setup`
- [Recovery Alarm Control](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java): `bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java`
- [Recovery Receiver](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java): `bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java`
- [Permission Screen](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/bridge-source/app/src/main/java/com/jaskran/wadbbridge/PermissionActivity.java): `bridge-source/app/src/main/java/com/jaskran/wadbbridge/PermissionActivity.java`
- [MCP Watchdog](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-mcp-watchdog): `scripts/wadb-mcp-watchdog`

### Security and Status

- [Control Center](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/ai-info): `scripts/ai-info`
- [Installed Integrity](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/security/verify-installed.js): `security/verify-installed.js`
- [Release Verification](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/security/verify-release.js): `security/verify-release.js`
- [Install Preflight](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/security/install-path-preflight.js): `security/install-path-preflight.js`
- [Phone Capabilities](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/phone-capabilities): `scripts/phone-capabilities`
- [Toolkit Notifications](https://github.com/jaskran0417/ai-termux-wadb-toolkit/blob/main/scripts/wadb-notify): `scripts/wadb-notify`

### Other components

- **Phone Owner**
- **AI Assistant**

## Connections

- Phone Owner → AI Assistant: requests setup (evidence: `README.md`)
- AI Assistant → Desktop Commander: uses connection (evidence: `README.md`)
- Desktop Commander → Termux Environment: accesses tools (evidence: `README.md`)
- AI Assistant → Control Center: runs commands (evidence: `README.md`)
- Control Center → Wireless ADB Controls: manages Wi-Fi ADB (evidence: `README.md`)
- Control Center → ADB Discovery: discovers devices (evidence: `README.md`)
- Control Center → ADB Connection: connects ADB (evidence: `README.md`)
- Control Center → WADB Bridge: manages Bridge (evidence: `README.md`)
- AI Assistant → Local Termux Shell: uses local shell (evidence: `README.md`)
- AI Assistant → Local Android Shell: uses local shell (evidence: `README.md`)
- Control Center → MCP Lifecycle: manages lifecycle (evidence: `README.md`)
- Control Center → GitHub Controls: configures integration (evidence: `README.md`)
- Control Center → Recovery Setup: configures recovery (evidence: `README.md`)
- Recovery Alarm Control → Recovery Receiver: schedules or cancels (evidence: `bridge-source/app/src/main/java/com/jaskran/wadbbridge/RecoveryControlReceiver.java`)
- Recovery Receiver → Termux Environment: starts recovery job (evidence: `bridge-source/app/src/main/java/com/jaskran/wadbbridge/McpRecoveryReceiver.java`)
- Control Center → MCP Watchdog: manages watchdog (evidence: `README.md`)
- Control Center → Installed Integrity: checks installation (evidence: `README.md`)
- Phone Owner → Release Verification: verifies release (evidence: `README.md`)
- Control Center → Install Preflight: preflights install (evidence: `README.md`)
- Control Center → Phone Capabilities: reports capabilities (evidence: `README.md`)
- Recovery Receiver → Toolkit Notifications: reports recovery state (evidence: `README.md`)
- Recovery Setup → Permission Screen: opens permission screen (evidence: `README.md`)
