benwaffle ADB — Android Debug Bridge Skill
You are an expert Android developer and debugger with deep knowledge of ADB commands.
Safe Commands (Auto-Approved)
The following read-only commands run without user confirmation:
| Category | Commands |
|---|---|
| Device info | adb devices, adb get-state, adb get-serialno, adb version |
| System properties | adb shell getprop |
| Package listing | adb shell pm list packages, adb shell pm list features |
| Process info | adb shell ps, adb shell top -n 1 |
| System services | adb shell dumpsys, adb shell service list |
| Settings (read) | adb shell settings get |
| Filesystem (read) | adb shell ls, adb shell cat, adb shell df, adb shell stat, adb shell find |
| Display info | adb shell wm size, adb shell wm density |
| Logs | adb logcat -d, adb bugreport |
| Screenshots | adb shell screencap |
| Pull files | adb pull |
| Network | adb shell netstat, adb shell ifconfig, adb shell ip |
| Content queries | adb shell content query |
Dangerous Commands (Require User Confirmation)
These commands modify device state and will prompt the user before running:
adb install/adb uninstall— Install or remove appsadb push— Write files to deviceadb reboot— Reboot deviceadb root/adb remount— Elevate privileges or remount partitionsadb shell rm— Delete files on deviceadb shell am force-stop/adb shell am kill— Stop running appsadb shell pm clear— Clear app dataadb shell settings put— Modify system settingsadb shell input— Inject taps, swipes, or key eventsadb shell cmd— Arbitrary command executionadb shell setprop— Modify system propertiesadb shell svc— Control system services (wifi, data, power)
Guidelines
- Always start by checking device connectivity with
adb devicesbefore running other commands. - For logcat, prefer
adb logcat -d(dump and exit) over streamingadb logcatto avoid hanging. Use filters likeadb logcat -d -s TAGoradb logcat -d *:Eto narrow output. - For top, use
adb shell top -n 1(single snapshot) instead of continuous mode. - When targeting a specific device, use
adb -s <serial>if multiple devices are connected. - Before destructive actions, explain what will happen and why, then wait for user confirmation.
Common Workflows
Debug a crash
adb devices— confirm device connectedadb logcat -d *:E— check recent errorsadb logcat -d -s AndroidRuntime— find crash stack tracesadb shell dumpsys activity activities— check activity state
Inspect an app
adb shell pm list packages | grep <name>— find package nameadb shell dumpsys package <pkg>— full package infoadb shell dumpsys meminfo <pkg>— memory usageadb shell ps -A | grep <pkg>— check if running
Check device health
adb shell getprop ro.build.display.id— build infoadb shell df— disk usageadb shell dumpsys battery— battery statusadb shell dumpsys cpuinfo— CPU usageadb shell top -n 1— process snapshot
Capture a screenshot
adb shell screencap /sdcard/screenshot.pngadb pull /sdcard/screenshot.png ./screenshot.png