Back to directory

dsh-android

Curated pickMaintenance: Active

zseven-w/dsh-android

DeepSeek Harness plugin for Android — build, run, and interact with a live emulator or USB device stream inside a conversation, driven entirely through adb.

View on GitHub
$ dsh plugin --profile web add @zseven-w/dsh-android@latest

116

stars

8

forks

TypeScript

Language

MIT

License

2026-08-21

Created

2026-08-21

Last push

A native DeepSeek Harness plugin that streams a live Android device (emulator or USB) into the chat and exposes 20 adb-driven agent tools — screenshots, UI taps, Gradle build & run, OCR, logcat and diagnostics — through signed in-process routes.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-25

License

MIT

01What can it help you accomplish?

  • Drive a live Android emulator or USB phone from inside a DSH conversation

    A live in-process device stream plus 20 agent tools for screenshots, UI taps, Gradle build & run, OCR, logcat and process inspection

    Mobile developers and agents who want to build, run and inspect Android apps without leaving DeepSeek Harness

  • Build, install and launch a Gradle app on the device

    A debug APK built via ./gradlew assembleDebug, installed with adb install -r, and launched live in the panel

    Android engineers who want the agent to drive the build-and-run loop

  • Inspect UI, text and logs through vision and debug tools

    uiautomator UI-tree with element taps, OCR find / tap / wait for text, logcat snapshot or follow, process backtraces and meminfo

    QA and automation engineers who need to drive and observe a real device's UI and state

02How to install into DeepSeek Harness

Prerequisites

  • Node ≥ 24.11.0.
  • adb from the Android SDK platform-tools, resolved via the ADB env var, PATH, or ANDROID_HOME
  • A device: an emulator of any product, or a phone with USB debugging enabled.
  • DSH ≥ 0.1.0-rc.6 with the web bundle for the panel.
  • A macOS host for OCR (only android_find_text / android_tap_text / android_wait_for need it)

Installation steps

  1. 01

    $ dsh plugin --profile web add @zseven-w/dsh-android@latest

  2. 02

    $ dsh web

  3. 03

    pnpm add @zseven-w/dsh-android

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH plugin: install via the dsh CLI and it registers 20 adb-driven agent tools and a live in-process device stream into the web conversation.

  • Live device stream & sidebar panel

    an online adb serial or an AVD namean in-process multipart/x-mixed-replace PNG stream rendered in a persistent sidebar panel

    spawns a persistent `adb exec-out` screencap child while a stream is live
  • Gradle build & run

    a Gradle project patha debug APK built via ./gradlew assembleDebug, installed with adb install -r, and launched on the device

  • UI tree, element & OCR taps

    resource-id / text / content-description or an OCR screen queryuiautomator UI-tree nodes, element-center taps, and OCR find / tap / wait results

  • Logs, processes & diagnostics

    a device serial and an optional bundle_id / filterlogcat snapshot / follow, running process list, ANR / crash backtrace, meminfo and app info

04Who is it for? When not to use it?

Good for

  • Mobile developers and agents who want to build, run and inspect Android apps without leaving DeepSeek Harness
  • Android engineers who want the agent to drive the build-and-run loop
  • QA and automation engineers who need to drive and observe a real device's UI and state

Not for

  • OCR tools (android_find_text / android_tap_text / android_wait_for) require a macOS host with Apple's Vision framework; on Linux and Windows they report that OCR needs the macOS Vision framework, while the other 17 tools are unaffected.

05Compatibility, maintenance and safety notes

  • OCR tools (android_find_text / android_tap_text / android_wait_for) require a macOS host with Apple's Vision framework; on Linux and Windows they report that OCR needs the macOS Vision framework, while the other 17 tools are unaffected.
  • Non-ASCII / CJK / emoji typing needs the optional ADBKeyboard IME on the device; `adb shell input text` is ASCII-only, so without it the plugin refuses non-ASCII typing with an install hint rather than silently dropping characters.
  • `android_shutdown` cannot power off a physical phone — adb has no such verb — so the tool refuses with the reason instead of pretending.
2026-08-212026-08-21Not specified by the author

MIT · freshly published (repo created 2026-08-21, last push 2026-08-21); README cites current plugin release 0.1.0-rc.4, tested with DSH 0.1.1-rc.1

06Frequently asked questions

How do I install DSH Android into DeepSeek Harness?

Run `dsh plugin --profile web add @zseven-w/dsh-android@latest`, then `dsh web` to open the web UI where the live device panel appears. You can also add `@zseven-w/dsh-android` as a dependency of an existing profile package with pnpm.

What are the requirements?

You need Node ≥ 24.11.0, adb from the Android SDK platform-tools (resolved via the ADB env var, PATH, or ANDROID_HOME), and a device — an emulator or a USB phone with debugging enabled. The web panel needs DSH ≥ 0.1.0-rc.6 with the web bundle.

Does it need a real phone or can it use an emulator?

Either works. adb treats emulators and phones identically through one code path; pass an online serial to stream it, or an AVD name to `android_boot` and the plugin launches and streams that emulator once it finishes booting.

Which tools require macOS?

Only android_find_text, android_tap_text and android_wait_for use Apple's Vision OCR framework, so they need a macOS host. On Linux and Windows those three report that OCR needs macOS; the other 17 tools work everywhere.

How is the device stream kept safe?

The stream is produced in-process and served only through signed, loopback-fenced `/_dsh/dsh-android/*` routes; every capability requires a loopback peer, a loopback Host header, and same-origin Fetch-Metadata/Origin checks, with HMAC-SHA256 capabilities that expire within 10 minutes.

08Data and sources

  • Author-claimedgithub.com8c1d19a0019f…

    DSH Android gives the agent a real Android device inside the conversation — and gives you the pixels.

  • Author-claimedgithub.com8c1d19a0019f…

    All 20 tools are registered on every host and return plain JSON — visual bytes reach the UI only through `presentationMe…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-25. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.