ADB Device Control
Use this skill whenever the user asks to operate a connected Android device, verify a screen on-device, navigate through an app, run adb commands, capture screenshots, inspect logcat, or set up local-server testing through adb reverse.
Default Workflow
- Confirm a device is connected:
C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 status - Start a recorded session before manual navigation:
C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 start -Label exofit-home - Use scripted actions so every step saves evidence:
C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 launch -Package com.exosystems.fit C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 tap -X 720 -Y 205 C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 swipe -X1 700 -Y1 1900 -X2 700 -Y2 700 -Duration 350 C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 text -Text "hello" - Capture current state after any non-scripted action:
C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 capture -Name after_manual_step - For local server testing, set reverse explicitly:
C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 reverse -Port 18089
Evidence Policy
Prefer the script commands over raw adb input because each action stores:
- screenshot PNG
- recent logcat text
- current foreground Activity
- executed action metadata in
actions.jsonl
Artifacts are stored under:
<repo>\artifacts\adb\<timestamp-label>\
If the repo path is unclear, pass -OutRoot <path>.
Launching Apps
Use launch -Package ... first. It uses Android monkey launcher intent, which works even when internal Activities are exported=false.
If the user asks to open a non-exported Activity directly, try normal am start only if appropriate, but expect SecurityException. Fall back to the launcher/Splash route and navigate with taps.
Reading Screens
First try screenshots. uiautomator dump may crash on some devices, so do not rely on it as the only verification path. Use:
C:\Users\lenovo\.codex\skills\adb-device-control\scripts\adb-device.ps1 screenshot -Name current
Then inspect the saved image with the image viewer tool.
Common Packages
For exoFit, check installed packages first:
adb shell pm list packages | Select-String exosystems
Common candidates:
com.exosystems.fitcom.exosystems.fit.test