ravenli059/dsh-android-agent
Drives an Android phone over WebSocket from a Phone panel in DSH Web: open apps, tap, swipe, type, screenshot and dump the UI tree.
Turns a real handset into a tool surface: openApp by package name, tap and swipe at pixel coordinates with configurable gesture duration, inputText with an optional tap-to-focus first, key events, screenshots previewed and downloadable from the panel with agent saves under ~/.dsh/phone-screenshots, and getUI accessibility dumps. The UI-tree helpers are the interesting half — phone_ui_find locates nodes by contains or resourceId and returns bounds plus a tap centre, and phone_ui_tap clicks the best match — which is how an agent clicks "the Confirm button" instead of guessing coordinates. Limits it admits: inputText depends on accessibility injection so some fields reject it, screenshots travel as base64 in JSON-RPC, and auto-reconnect can replay a non-idempotent operation.
Install
dsh plugin --profile web add dsh-android-agentThe npm line. The README's install section still says npm is "not yet published", but the registry does serve dsh-android-agent 0.1.0 with its repository field pointing at this repo, so the command above works today — the stale heading is the README's, not a claim of ours. The phone side is separate: the phone runs the companion Android app from zhu1090093659/dsh-android-agnet (the author's spelling in the link) and you add the device in the dsh-web Phone panel with an alias, ws://phone-ip:8080/ws?token=... and a token. Restart dsh web afterwards.
Compatibility
Both devices on the same LAN, one WebSocket per device with auto-reconnect capped at three attempts and a 5-second status refresh. Device config lives in ~/.dsh/dsh-phone.json at 0600 inside a 0700 directory, and the README says plainly that tokens are stored in plaintext there — the same trust model as dsh-ssh. All /api/dsh-phone/* routes are loopback-only with same-origin checks, and agents can only use devices you configured in the GUI first. The phone needs its own prerequisites, documented in the plugin's phone section.
Details
- Repo: ravenli059/dsh-android-agent
- Category: Tools & Capabilities
- Stars: 1
- Version: 0.1.0 (npm)
Alternatives
anht3889/dsh-mcp-management · Wenaixi/dsh-cfbridge · welsione/dsh-mmx-bridge