MIT-licensed native DSH plugin that surfaces a live iOS Simulator and USB iPhone inside the conversation: 22 tools, a persistent live panel, semantic UI automation and SwiftUI preview hot reload. Requires a Mac / Xcode.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-23
License
MIT
01What can it help you accomplish?
Drive a real iOS Simulator (or a USB-connected iPhone) interactively from inside a DeepSeek Harness conversation
A live MJPEG panel of the booted device with tap/drag/rotate/Home, plus JSON tool results: boot, build & run Xcode projects or Swift packages, accessibility UI tree, OCR find/tap, logs, process/backtrace/leaks
Mobile developers and agents who test or automate iOS apps and want the device pixels and controls surfaced directly inside DSH
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness (DSH) installed — the README states it was tested with DSH 0.1.1-rc.1
- A Mac with the iOS Simulator / Xcode for simulator and real-device flows (the README states that on non-macOS hosts the tools stay registered but fail with an explanatory error)
Installation steps
- 01
Add the plugin: `dsh plugin --profile web add @zseven-w/dsh-ios@latest`
$ dsh plugin --profile web add @zseven-w/dsh-ios@latest
- 02
Start the web UI: `dsh web`
$ dsh web
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Native DSH plugin — a live iOS Simulator and real iPhone over USB driven from inside a DeepSeek Harness conversation via 22 registered agent tools and a persistent live MJPEG panel
Live simulator in the conversation
Booted device udid / name from `ios_sim_devices`→A serve-sim MJPEG stream proxied through signed `/_dsh/dsh-ios/*` routes into a persistent right-side panel
serve-sim binds 127.0.0.1 in a dedicated port range (loopback-only transport)Real iPhone over USB
USB-connected, unlocked iPhone (developer mode on)→`ios_real_start_wda` builds and launches WebDriverAgent, tunnels control (REST) and screen (MJPEG) over loopback into the same panel
builds and launches WebDriverAgent on the phone (writes to the device)every real-account tap is gated by the plugin's identify-before-tap rulesSemantic UI automation & SwiftUI preview hot reload
`ios_sim_ui_tree` / `ios_sim_find_text` for identity- or OCR-based taps; `ios_sim_preview` for SwiftUI previews→Accessibility-tree taps, OCR find/tap, and ~2–5 s hot-swap of SwiftUI preview edits into the running simulator
04Who is it for? When not to use it?
Good for
- Mobile developers and agents who test or automate iOS apps and want the device pixels and controls surfaced directly inside DSH
Not for
- The simulator and real-device tools need a Mac (iOS Simulator / Xcode). The README states that on non-macOS hosts the tools stay registered but fail with an explanatory error, except `ios_sim_preview` status which reports `{ running: false }` on any host.
- A real iPhone must be unlocked and in developer mode; every real-account tap is gated by the plugin's identify-before-tap rules, and the device must be connected over USB.
05Compatibility, maintenance and safety notes
- The simulator and real-device tools need a Mac (iOS Simulator / Xcode). The README states that on non-macOS hosts the tools stay registered but fail with an explanatory error, except `ios_sim_preview` status which reports `{ running: false }` on any host.
- A real iPhone must be unlocked and in developer mode; every real-account tap is gated by the plugin's identify-before-tap rules, and the device must be connected over USB.
- Visual bytes reach the UI only through signed, expiring URLs served by the DSH webserver; every route requires a loopback peer, a loopback Host, and Fetch-Metadata/Origin checks, and HMAC capabilities expire within 10 minutes.
MIT · pre-release (latest release v0.1.0-rc.4, 2026-08-23; tested with DSH 0.1.1-rc.1)
06Frequently asked questions
How do I install DSH iOS Simulator?
Run `dsh plugin --profile web add @zseven-w/dsh-ios@latest` to add the plugin, then `dsh web` to open the web UI. The README notes it was tested with DSH 0.1.1-rc.1.
Do I need a Mac?
Yes for the simulator and real-device flows — the README states that on non-macOS hosts the tools stay registered but fail with an explanatory error (only `ios_sim_preview` status is safe everywhere, reporting `{ running: false }`).
Can it control a physical iPhone?
Yes. `ios_real_start_wda` builds and launches WebDriverAgent on a connected, unlocked iPhone in developer mode, tunnels its control and screen ports over loopback, and streams it into the same panel. Every real-account tap is gated by identify-before-tap rules.
How are device images kept safe?
Visual bytes reach the UI only through signed, expiring URLs served by the DSH webserver. Every route requires a loopback peer, a loopback Host, and Fetch-Metadata/Origin checks, and HMAC capabilities expire within 10 minutes — no image blocks, no screen-recording files.
07Related DSH workflows
open-design
by nexu-io
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / DeepSeek Harness / OpenCode & 20+ CLIs via BYOK.
picgo
by molunerfinn
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosting services (S3, GitHub, Cloudflare R2, Imgur, Aliyun OSS...). Paste, upload, done.
deepseek-harness-desktop
by anywhere-labs
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem — everything is a plugin, even the desktop itself.
openbiliclaw
by whiteguo233
Local-first, open-source AI content discovery agent that learns your taste and proactively finds content across Bilibili, Douyin, YouTube, Reddit, X and the open web.
08Data and sources
A live, interactive iOS Simulator inside a DeepSeek Harness conversation — plus your real iPhone over USB.
22 agent tools · live MJPEG sidebar panel · simulator & real iPhone over USB
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-23. Found an error? Submit a correction.