WearBridge

WearBridge is a secure, consent-first Wireless Debugging bridge and terminal for Wear OS. Pair your watch’s Wireless Debugging service directly on-device, execute ADB shell commands on your wrist, and safely run typed background tasks with full control over which apps are authorized to access your watch. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔒 CONSENT-FIRST ARCHITECTURE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ WearBridge puts you in complete control of your watch's capabilities: • Cryptographic Verification: Access grants are cryptographically bound to the partner app’s exact SHA-256 signing certificate. Re-signing an app immediately invalidates access. • Typed Task Catalog: Partner applications never receive raw shell access or arbitrary permissions. They can only invoke explicitly permitted, typed tasks (e.g., diagnostics, capabilities, battery status) that you approve. • On-Wrist Consent: Every authorization request must be manually reviewed and approved directly on your watch screen. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 💻 BUILT-IN ADB SHELL TERMINAL ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Need to run shell commands on your watch without plugging in a computer? • Runs commands natively under the Android Shell user (UID 2000), offering full adb shell capability on your wrist. • Clean, modern terminal interface optimized for round and square Wear OS displays. • Secure local loopback (127.0.0.1) session authentication prevents unauthorized third-party apps from accessing the terminal. • Safety safeguards with execution timeouts and output limits. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📱 OPTIONAL PHONE COMPANION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ WearBridge is 100% standalone and works entirely on your watch without a smartphone. However, an optional phone companion app is included for extra convenience: • Fast Pairing: Type the 6-digit Wireless Debugging code comfortably on your phone keyboard instead of the watch screen (the pairing handshake itself still runs securely on the watch). • Remote Terminal: Execute adb commands on your watch using your phone's full-size keyboard. • Access Management: Monitor connected watch state, inspect active shell UIDs, and instantly revoke permissions for any partner app. • Privacy Log: View the on-device activity log. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🛡️ PRIVACY & OPEN SOURCE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • Zero Telemetry: No analytics, tracking, or external data collection. • Local Only: Activity logs remain strictly on your watch. • Transparent & Open: Built for power users and developers who value transparency, privacy, and device control. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🚀 HOW TO GET STARTED ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. Enable Developer Options on your Wear OS watch (Settings > System > About > Versions > Tap Build Number 7 times). 2. Turn on Wireless Debugging in Developer Options. 3. Open WearBridge and select "Pair". 4. Enter the 6-digit pairing code shown on your watch (either on the watch screen or via the optional phone companion). 5. You're ready to run terminal commands and authorize trusted partner applications! Requirements: • A smartwatch running Wear OS (Android 11 / API 30 or newer). • Local Wi-Fi connection for initial Wireless Debugging pairing.