Introduction¶

DeepSeek Harness (dsh) agent tasks are typically handled on a development machine via dsh web or the command line. When stepping away from your desk, checking ongoing sessions or sending a new task on a phone often relies on remote desktop or opening unrelated tools, which doesn’t align with the local dsh project directory and session history.

dsh-phone is a client-class DSH plugin provided by maintainer opentandem: it displays a QR code in dsh web. After scanning with a mobile browser and logging in to OpenTandem to authorize, tasks are sent to the computer running dsh. Existing local sessions appear in the phone’s task list; the phone and computer use the same session. Community directory page: https://www.skillhub.cn/plugins/opentandem/dsh-phone.

What is this¶

In short: dsh-phone connects DeepSeek Harness to a phone using the dsh web sidebar, QR code pairing, and the OpenTandem mobile app. After pairing, OpenTandem routes tasks to the local dsh for execution.

The plugin itself primarily provides a small page and a pairing flow; the long-term persistence of phone connectivity is handled by the OpenTandem CLI and its background Runner (an independent program, not part of this plugin’s bundled code). The current package.json version is 0.1.5, and the plugin license is MIT; the OpenTandem CLI and Runner source code are public, with a license of AGPL-3.0.

Core Features¶

The capabilities below are documented in the README and can be verified against the documentation:

1. Sidebar Entry: Upon enabling, a Phone appears in the dsh web sidebar, allowing you to Show QR code.
2. Scan to Pair: The phone scans the QR code in the browser, logs in to OpenTandem on the device, and clicks Allow; the dsh web page displays that the computer is connected.
3. Session Sync: The phone’s OpenTandem shows the dsh project folder and recent sessions, allowing you to continue or create new tasks; it shares the same session as the computer.
4. Switch Account: Click Switch account on the pairing page; a new connection requires clicking Allow on the phone again; the current connection persists until you re-authorize on the phone.
5. Security and Account Boundaries: The OpenTandem username and password are only used for login on the phone; the plugin does not access them. It does not use DeepSeek account credentials; tasks use the models configured in your dsh. The routing utilizes dsh’s built-in connection check, and the POST request only accepts application/json.
6. Background Persistence: The first pairing downloads and installs the OpenTandem CLI and starts the Runner. The phone can still connect to the host even after dsh web is closed (you can use opentandem uninstall or remove the host in OpenTandem settings).

Installation and Activation¶

Installation requires using the dsh web profile (consistent with the Phone sidebar page). The official documentation offers three methods; choose any one.

Install from npm:

dsh plugin --profile web add dsh-phone

Install from GitHub:

dsh plugin --profile web add github:opentandem/dsh-phone

Or open Plugins → Add plugin in dsh web, enter dsh-phone, and click Enable now. If the sidebar does not show a Phone, refresh the page once.

Before installing, you should read the repository source code and the license; the plugin runs with the user and permissions of the current dsh process. Tasks sent from that authorized OpenTandem account will be executed locally via dsh. Only click Allow when you initiate the pairing yourself.

Typical Usage¶

You can reproduce the full workflow by following the steps in the README:

1. In the dsh web sidebar, click Phone, then Show QR code.
2. Scan the QR code with your phone and open the link in a browser.
3. Log in to OpenTandem on the phone and click Allow.
4. Confirm that the dsh web Phone page shows that it is connected.
5. In the phone’s OpenTandem, check the task list (which includes the dsh project directory and sessions), and continue the session or create a new task.

To connect another OpenTandem account, use Switch account on the Phone page and click Allow for the new connection on the phone.

What happens on the host during first pairing¶

Before clicking Show QR code, it is recommended to understand the download and background behaviors triggered by the plugin (a summary of the README table is below):

OpenTandem Runner and CLI source code: https://github.com/opentandem/opentandem.

Configuration Options¶

Only environment variables explicitly mentioned in the documentation:

Use Cases and Notes¶

Who is this for: Developers who are already running dsh on a desktop or laptop and want to view the same workspace, continue chats, or send tasks via OpenTandem on a phone, and are willing to install the OpenTandem CLI and the background Runner.

Compatibility: The README states that it has been tested only on macOS with dsh 0.2.1-rc.2 and 0.2.2-rc.1; Windows and Linux have not been tested.

Ecosystem Note: DeepSeek Harness follows a “Everything is a plugin” philosophy; community directories like SkillHub are independent sites with no official affiliation to DeepSeek / Hypersphere. This document describes the community plugin opentandem/dsh-phone, not an official app store entry.

Permissions and Security: Pairing effectively allows that OpenTandem account to submit tasks to your local dsh; the Runner will persist until you uninstall or remove the device. Please verify the GitHub repository and the scope of the MIT / AGPL licenses before installing.

Conclusion¶

dsh-phone links the QR code pairing on dsh web with the OpenTandem mobile workspace, allowing phone tasks to land on your local dsh and reuse existing sessions and project directories. Refer to the documentation and source code:

• Directory page: https://www.skillhub.cn/plugins/opentandem/dsh-phone
• GitHub: https://github.com/opentandem/dsh-phone