Droid Commander is an offline-first security training, device service orchestration, and diagnostic prototype platform designed specifically for licensed technical service professionals and mobile security researchers.
Operating under a strict fail-closed zero-trust architecture, Droid Commander allows technicians to perform hardware diagnostics, host security audits, firmware integrity verifications, and recovery deployments across both Local Host devices and Remote USB OTG Target devices—without requiring external cloud connectivity or exposing device data.
- Local Host (
LOCAL_HOST_SELF): Direct self-assessment of the technician’s Android host device. - Remote USB OTG (
REMOTE_TARGET_USB): Direct bulk transport communication over USB OTG host interfaces viadroid-commander-usb-host-module.kt.
- Screenless Control: Service target devices with shattered, unresponsive, or liquid-damaged OLED screens without requiring touch input.
- Buttonless Recovery: Programmatic software reboot macros (
adb reboot bootloader,adb reboot recovery, Fastboot flashing) for devices with missing or stuck power/volume keys. - BMS VBUS Power Rail Cut-Off: Real-time battery voltage/thermal profiling with a manual 5V VBUS rail cut-off switch to prevent short circuits on liquid-damaged boards.
- Fail-Closed Gateways: Privileged execution methods, package installations, and elevated commands are locked by default and require explicit ECDSA-signed owner consent tokens (
OWNER_APPROVED_ROOT_ACCESS). - Non-Malicious Diagnostic Testing: Controlled diagnostic testing generation (
KEYSTORE_CHALLENGE_VECTOR,SELINUX_AUDIT_STUB) to verify security boundaries under owner authorization.
- 1-Tap Biometric Authentication: Uses native Android
BiometricPrompt/ StrongBox hardware Keystore to activate 15-minute emergency override sessions (BYPASS_TWO_PARTY_CONSENT,FORCE_USB_EXECUTION). - Session Lifetime Enforcement: Automatic countdown timers with automatic auto-expiration and instant manual revocation.
- Cryptographic Hash Chain: Every execution, deployment, or Break-Glass override appends a signed block to an immutable SHA-256 hash chain.
- Encrypted Telemetry Vault: Offline AES-256-GCM encrypted archives with HMAC-SHA256 signature binding for compliance reports.
- Zero-Trust Intelligence Feeds: Downloads CVE databases, OEM partition manifests, and USB VID/PID registries with ECDSA signature verification.
- Target Interaction Registry: Historical tracking, hardware serial indexing, session timelines, and live cybernetic schematic rendering (
DeviceIllustrationCard).
- Operations Dashboard (
home-screen-v5.tsx) - Central dual-mode toggle with live schematic visual cards. - Target Device Registry (
device-history-screen-v2.tsx) - Historical device interaction tracking & session logs. - Vulnerability Scanner (
vulnerability-scanner-screen-v2.tsx) - CVE risk assessment & remediation playbooks. - Host ADB Shell (
adb-shell-screen-v2.tsx) - Terminal emulator with preloaded diagnostic macros. - Firmware Deployment Hub (
firmware-deployment-screen-v2.tsx) - Vendor image & OTA flashing interface. - Online Knowledge Sync (
online-knowledge-sync-screen.tsx) - Signed CVE & partition hash update engine. - Passkey Break-Glass (
passkey-break-glass-screen.tsx) - Biometric emergency scope elevation. - Privileged Action Ledger (
ledger-inspector-screen-v2.tsx) - SHA-256 audit chain inspector & tamper verifier. - BMS Power Telemetry (
power-telemetry-screen-v2.tsx) - Live voltage, thermal, & VBUS rail cut-off controls. - Reports & Telemetry Vault (
reports-vault-screen-v2.tsx) - Encrypted PDF/JSON compliance report exporter. - Two-Party Consent (
consent-licensing-screen-v2.tsx) - License verification & scope permission matrix. - Keystore Audit (
keystore-audit-screen-v2.tsx) - Hardware StrongBox attestation & Root CA store inspector. - Firmware Integrity (
firmware-integrity-screen-v2.tsx) - Android Verified Boot (AVB) digest checker. - Splash & Boot (
splash-screen-v2.tsx) - Cybernetic boot animation & hardware readiness check.
droid-commander/
├── .gitignore # File exclusion rules & sensitive pattern blocklist
├── git-push-exclusion-guard.sh # Pre-push automated security scanner
├── repository-readme.md # Master repository architecture guide
│
├── native-core/ # Native Android Kotlin Drivers
│ ├── droid-commander-usb-host-module.kt
│ ├── fastboot-diagnostic-module.kt
│ └── droid-commander-keystore-attestation.kt
│
├── security-engines/ # Core Business & Security Logic
│ ├── live-host-assessment-cve-engine.ts
│ ├── root-detection-analyzer.ts
│ ├── owner-root-consent-manager.ts
│ ├── apk-sideload-module.ts
│ ├── diagnostic-payload-generator.ts
│ ├── passkey-auth-provider.ts
│ ├── passkey-emergency-service.ts
│ ├── break-glass-auth-service.ts
│ ├── online-knowledge-sync-engine.ts
│ ├── target-device-registry.ts
│ └── device-graphics-manager.ts
│
├── ui-components/ # React Native Design System & Screens
│ ├── device-illustration-card.tsx
│ ├── home-screen-v5.tsx
│ ├── device-history-screen-v2.tsx
│ └── ... (12 additional screen components)
│
└── documentation/ # Comprehensive Operational Documentation
├── field-operations-deployment-guide.md
├── ui-style-architecture-guide.md
├── developer-onboarding-architecture-guide.md
├── field-quick-reference-card.md
├── field-troubleshooting-guide.md
├── hardware-lab-testing-protocol.md
└── sample-ledger-chain-report.md
For detailed technical specifications, refer to the individual documentation guides:
- 📱 Field Operations & Deployment Guide
- 🎨 Cybernetic UI Style & Architecture Guide
- 👨💻 Developer Onboarding & Architecture Guide
- ⚡ Field Operations Quick Reference Card
- 🔧 Field Troubleshooting & Error Remediation Guide
- 🧪 Hardware Lab Testing & OTG Setup Protocol
- 📜 Sample Privileged Action Ledger Report
To ensure sensitive environments, release archives, or private signing keys are never pushed to GitHub:
# Run the pre-push exclusion guard before committing or pushing
./git-push-exclusion-guard.shDroid Commander v1.0.0-RELEASE — CodePhrex Mobile Security Orchestration Engine