DSH Mobile — DeepSeek Harness Remote
An open-source Android companion that puts your DeepSeek Harness in your pocket.
Drive sessions, review plans and goals, answer approvals and questions, and get notified
when the harness finishes — from your phone, over your local network.
DSH Mobile is an unofficial companion app for the
DeepSeek Harness (MIT), mirroring its web GUI
feature-for-feature in the harness's own visual language. Android only, Kotlin + Jetpack Compose.
The wiki is the user-facing guide:
getting started,
connecting,
troubleshooting,
a feature tour and an
FAQ.
Screenshots
| Connect | Chat | Trajectory |
|---|---|---|
![]() |
![]() |
![]() |
Recent harnesses with live reachability, LAN discovery, manual host:port, auto-connect. |
Streamed turns, a glyph per tool, expandable tool cards, permission picker. | The same session as a per-turn ledger with usage totals. |
| Session details | Subagents |
|---|---|
![]() |
![]() |
| Context breakdown, goal, plan mode, background jobs, queued turns, host info, session-log export. | The subagent catalog — open a child's transcript, follow up, or interrupt it. |
Features
- Connect effortlessly — auto-discovers a harness on your Wi-Fi (active subnet scan +
readiness handshake), remembers hosts and probes them for liveness on the way in, supports
manualhost:portentry, loopback for same-device setups, and auto-connect toggles
(last used / LAN / same device). - Discord-style navigation — swipe right from the left edge to open the workspace-grouped
chat list, swipe left to close it, swipe left from the right edge for the session details panel. - Full chat experience — streamed turns with reasoning disclosure, markdown,
terminal/diff/read/search/web tool cards, queue dock (edit / remove / steer), history paging,
image attachments. - Slash commands and skills — the composer adjudicates a
/line against the session's own
command catalog and runs it through the harness's command gateway; anything the catalog does not
claim is sent as a prompt, which is how skills are invoked. - Everything the GUI does — goals (phases, rounds, pause/resume/edit), plan mode + plan review,
permission approvals, user questions, todo dock, subagents (catalog, follow-ups, interrupt),
background jobs, workflow runs, skills, model selection, agent presets, session search,
trajectory ledger, session export, message feedback. - Notifications — turn complete, goal complete / blocked, review or question waiting for you;
background connection via a foreground service. - Looks like the harness — the exact DeepSeek Harness design tokens (colors, type, radii,
disclosure rows, shimmer, ink buttons) with light / dark / system themes. - 11 languages — English, 中文, हिन्दी, Español, Français, العربية, বাংলা, Português, Русский,
اردو, ไทย (RTL aware).
Requirements
- Android 8.0+ (minSdk 26).
- A running DeepSeek Harness
(tested against0.1.0-rc.7).
Quick start
- Install the latest APK from
Releases. - On your computer, make the harness reachable from your phone:
- USB / emulator:
dsh web, thenadb reverse tcp:3080 tcp:3080— in the app connect to127.0.0.1:3080. - Wi-Fi: apply the one-file LAN patch described in
harness/README.md, restartdsh web, then tap Scan network
in the app.
- USB / emulator:
- Pick a session, chat, and get notified when the harness is done.
If a connect attempt fails, the app names the cause; the wiki's
Troubleshooting page is
keyed on that exact sentence.
Compatibility & security
- See docs/COMPATIBILITY.md for the harness version matrix and
loopback-only surfaces. - Read docs/SECURITY.md first — the harness has no authentication; only
use LAN mode on trusted networks. The app says so on the connect screen for the same reason.
Building
./gradlew :app:assembleDebug # debug APK
./gradlew :app:assembleRelease # release APK (signed when keystore env is set)
The shipped version comes from the git tag: the release workflow exports DSH_VERSION_NAME from
the tag name, and versionCode is derived from it. A local build falls back to the literal inapp/build.gradle.kts.
See CONTRIBUTING.md for the development loop against a real harness, the module
layout, and the release workflow.
Repository
| Path | What |
|---|---|
core/ |
Pure-JVM protocol core: wire DTOs, RPC client, WebSocket downlinks, reconnect loop, session folding, notification classifier |
app/ |
Android UI: screens, discovery/connection, foreground service, notifications, i18n |
mock-harness/ |
Ktor mock of the harness /api server for tests |
tools/capture/ |
Records real harness traffic into conformance fixtures |
harness/ |
Companion patch + guide for LAN mode |
docs/ |
Architecture, protocol notes, compatibility, security |
License
MIT. Bundled third-party material is listed in
THIRD_PARTY_NOTICES.md. The DeepSeek Harness and its brand are property
of their respective owners; this project is an independent, community-built remote.




