dsh-android: A Live Android Device Control Plugin for DeepSeek Harness
zseven-w/dsh-android
A DSH plugin that streams a live Android device (emulator or USB phone) into the conversation, driving 20 agent tools via adb for build, run, UI control, and OCR.
dsh-android is an Android device plugin for DeepSeek Harness that lets the agent control an emulator or USB-connected phone directly in conversation. It drives the device via adb and provides 20 tools, including screen streaming, UI interaction, Gradle builds, and OCR. The sidebar renders the device screen in real time, supporting tap, drag, and rotate, with a three-button navigation panel. Secure routes ensure only authorized sessions can access the device stream, with capability tokens expiring in 10 minutes.
How to Install
dsh plugin --profile <your-profile> add @zseven-w/dsh-androidReplace --profile with the profile name you actually run (see ls ~/.dsh/profiles/): usually web in the browser UI, desktop or desktop-NNN in the desktop app.
- Category
- Tools & Capabilities
- Platform
- DSH Plugin
- Author
- zseven-w
- Distribution
- Plugin
dsh-android Key Features
dsh-android Repo Summary
What Does It Do?
DSH Android is a DSH plugin for DeepSeek Harness that brings a live Android device into the conversation, letting the agent control an emulator or USB-connected phone entirely through adb. It solves the problem of not being able to see and interact with a device in real time during a chat. The plugin provides 20 agent tools, including live screen streaming, UI interaction, Gradle builds, and OCR, all rendered in a persistent sidebar panel. It uses a single adb code path, so emulators and physical devices behave identically.
Core Features
- Live device stream: a multipart/x-mixed-replace PNG stream renders the device screen in a sidebar, supporting tap, drag, rotate, and a three-button navigation panel.
- 20 agent tools: device management, screenshot, interaction, Gradle build & run, app listing/launching, uiautomator tree parsing, OCR find/tap, logcat, process/memory inspection, and more.
- Native multimodal: image-capable models receive screenshots as image blocks, while text-only models get plain JSON summaries.
- Single adb code path: emulators, USB devices, and ip:port targets are handled identically, with no simulator/real-device split.
- Secure routes: all routes require loopback connections, Host header validation, and origin checks; capability tokens expire within 10 minutes.
How to Use This Plugin?
After enabling the plugin in DSH, the agent can connect to a device via adb and use the tools to build, install, interact with the UI, and read logs. Users can watch the live device screen in the sidebar and interact directly using the three-button panel. To adjust behavior, modify the plugin configuration as needed.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: zseven-w/dsh-android. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
