dev-mode-cli

v1.0.10

Published

13 days ago

Official CLI tool for Dev Mode — instantly toggle Android Developer Options, USB & Wireless ADB, and auto-connect over Wi-Fi without manual typing.

0High
0Medium
0Low

jhayrdev

android developer-options adb wireless-adb devtools cli devmode dev-mode

🚀 Quick Start

No installation required! Run instantly using npx:

  ██████╗ ███████╗██╗   ██╗   ███╗   ███╗ ██████╗ ██████╗ ███████╗  │        ▄▄           ▄▄
  ██╔══██╗██╔════╝██║   ██║   ████╗ ████║██╔═══██╗██╔══██╗██╔════╝  │        ▀██▄  ▄▄▄▄  ▄██▀
  ██║  ██║█████╗  ██║   ██║   ██╔████╔██║██║   ██║██║  ██║█████╗    │       ▄████████████████▄
  ██║  ██║██╔══╝  ╚██╗ ██╔╝   ██║╚██╔╝██║██║   ██║██║  ██║██╔══╝    │      ████  ████████  ████
  ██████╔╝███████╗ ╚████╔╝    ██║ ╚═╝ ██║╚██████╔╝██████╔╝███████╗  │      ████████████████████
  ╚═════╝ ╚══════╝  ╚═══╝     ╚═╝     ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝  │     (════════[● ON]═══════)
   ⚡ Android Quick-Toggle & Wireless ADB CLI  v1.0.10
   ─────────────────────────────────────────────────────────────────────────────────────────

              ⚡ DEV MODE : ACTIVATED [ON] ⚡
       [ Android Developer Options & Wireless ADB ]

# Enable Developer Options only
npx dev-mode-cli on

# Enable USB Debugging specifically
npx dev-mode-cli usb on

Or install globally to use bare devmode anywhere:

npm install -g dev-mode-cli
devmode status

📱 Choose Your Setup Tutorial

Dev Mode supports two simple workflows depending on whether you want a standalone terminal utility or a mobile app toggle with Quick Settings tiles:

🔹 Option 1: Setup WITHOUT Mobile App (Pure Terminal CLI)

Best for developers who just want quick terminal commands on their PC to toggle settings and auto-connect ADB wirelessly.

Enable Developer Options on Phone (One-time):
- Open Settings > About Phone.
- Tap Build Number 7 times until you see "You are now a developer!".
Enable USB Debugging:
- Go to Settings > System (or Additional Settings) > Developer Options.
- Turn USB Debugging to ON.
Connect Device to PC:
- Plug your Android device into your computer with a USB cable.
- When the prompt "Allow USB debugging?" appears on your phone screen, check "Always allow from this computer" and tap OK / Allow.

Run CLI Commands Directly:

# Toggle Developer Options on/off
devmode on
devmode off

# Enable Wireless ADB & auto-connect over Wi-Fi without typing IPs/ports
devmode wifi on

# Speed up UI animations to 0.5x for ultra-fast testing
devmode speed 0.5

🔹 Option 2: Setup WITH Dev Mode Mobile App (Android Tiles & Widgets)

Best for developers who want 1-tap toggles directly from their Android Quick Settings panel, homescreen widget, or phone without touching a terminal every time.

Download the Mobile App:
- Download the latest APK from the official Dev Mode Mobile Releases.
Install on Phone:
- Open and install the downloaded .apk file on your Android device.
Connect via USB (One-time permission grant):
- Connect your phone to your PC via USB cable (with USB Debugging turned ON).
Grant Secure Settings Permission with One Command:
- Run the dedicated grant command from your terminal:
```
devmode grant
```
  (Or via npx: npx dev-mode-cli grant)
  Under the hood, this executes:
```
adb shell pm grant com.devmode.app android.permission.WRITE_SECURE_SETTINGS
```
Done! Unplug and Enjoy:
- You can now safely unplug the USB cable!
- Add the Dev Mode Quick Settings Tile to your Android notification shade, or use the in-app switch to toggle Developer Options anytime directly from your phone!

✨ Features Overview

📖 Command Reference

# Core Toggles & Display
devmode on                     # Turn ON Developer Options (displays green ASCII icon)
devmode off                    # Turn OFF Developer Options only
devmode icon                   # Display official Dev Mode green ASCII art icon
devmode status                 # Inspect live device details, IP, port, and status flags

# Mobile App Bridge & Permissions
devmode bridge                 # Inspect direct Wi-Fi bridge to Mobile App (ADB bypassed)
devmode grant                  # Grant WRITE_SECURE_SETTINGS permission to Dev Mode Mobile App

# Wireless ADB (Auto-Connect)
devmode wifi on                # Enable Wireless Debugging and auto-connect
devmode wifi off               # Disconnect and disable Wireless Debugging
devmode wifi connect           # Reconnect to discovered or cached wireless device
devmode wifi connect <ip:port> # Connect to a specific endpoint

# Expo & Android Dev Suite
devmode auto                   # Interactive menu: press one key (o/u/w/s/a/b/i...) to run any command
devmode start                  # Auto-detects project: starts Expo server (or Native Studio for pure Android)
devmode run                    # Alias for devmode start (works identically)
devmode start --native         # Launch Native Studio for Kotlin/Gradle development (hotkeys: s sync, i reinstall, r restart, l logcat)
devmode studio                 # Alias for devmode start --native (lightweight Android Studio replacement)
devmode debug:android          # Build & launch debug app on device (npx expo run:android)
devmode reload                 # Fast-refresh active app (Metro & device)
devmode menu                   # Open React Native Dev Menu on device screen
devmode build:aab              # Compile production AAB via Gradle for Google Play (bundleRelease)
devmode build:android          # Compile debug APK via Gradle (assembleDebug)
devmode build:android --release# Compile release APK via Gradle (assembleRelease)
devmode install:apk --release  # Install latest APK of a variant (--release | --debug); never falls back to the other
devmode clean                  # Clean Gradle and Metro project caches
devmode logs                   # Stream filtered React Native / Expo logs
devmode reverse                # Set up ADB reverse port for Metro (8081)

# Hardware & System Tools
devmode usb on                 # Enable USB Debugging specifically
devmode usb off                # Disable USB Debugging specifically
devmode speed 0.5              # 2x Animation Speed Booster
devmode speed 1.0              # Reset animations to standard speed
devmode help                   # Show interactive help manual

🔌 How Auto Wireless Connect Works

┌─────────────────────────────────┐
│  Developer runs:                │
│  $ devmode wifi on              │
└────────────────┬────────────────┘
                 │
                 ▼
┌─────────────────────────────────┐
│ 1. Enable `adb_wifi_enabled 1`  │
│ 2. Query wlan0 IPv4 address     │
│ 3. Resolve dynamic TLS port     │
└────────────────┬────────────────┘
                 │
                 ▼
┌─────────────────────────────────┐
│ 4. CLI automatically executes:  │
│    adb connect 192.168.1.4:38291│
└────────────────┬────────────────┘
                 │
                 ▼
┌─────────────────────────────────┐
│ 🎉 Connected wirelessly!        │
│ Safely unplug your USB cable!   │
└─────────────────────────────────┘

🛠️ Prerequisites

Android Platform Tools (ADB): Ensure adb is installed and added to your system PATH.
- Download: Android Platform Tools
Device Permission (For Mobile App): If using alongside the Dev Mode Mobile App, grant secure settings permission once directly via the CLI:
```
devmode grant
```
(Or manual ADB command: adb shell pm grant com.devmode.app android.permission.WRITE_SECURE_SETTINGS)

💡 Troubleshooting Wi-Fi Connection

If devmode wifi on reports a connection timeout:

Same Wi-Fi Band: Ensure your PC and phone are connected to the exact same Wi-Fi band (e.g. both on 2.4GHz or both on 5GHz).
AP Isolation: Some routers (PLDT, Converge, Globe, etc.) have AP Isolation / Client Isolation enabled by default, blocking direct device-to-device communication. Turn off AP Isolation in your router admin panel, or connect your phone to your PC's Mobile Hotspot.

📄 License & Attribution

Distributed under the MIT License. Created by Ryderhxrzy.

Companion repository: Dev Mode Mobile App

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme