Introduction

When developing agents using DeepSeek Harness (hereinafter referred to as DSH), the agent in the chat defaults to completing all tasks by itself. However, since Cursor CLI is often already installed and logged in on many machines, sometimes users want to offload independent tasks with clear boundaries—such as “implement a feature” or “review a file”—directly to it, rather than manually switching windows and copying context.

dsh-cursor-acp solves this problem: it registers a cursor_agent tool, allowing the current chat’s agent to hand over independent tasks to the locally logged-in Cursor CLI (via ACP) during normal conversation. Below is an introduction in the order of preparation, installation, usage, and troubleshooting.

What is it

This is a DSH community plugin maintained by loeanxi, licensed under MIT, with the current version being 0.2.0. DSH’s philosophy is “everything is a plugin,” and this plugin is a community product under this concept.

Its one-sentence positioning: handing over independent tasks to the locally logged-in Cursor CLI (via ACP) during normal chat.

Two points need to be clarified: it is not a Cursor entry in the model selector, nor is it an official Cursor product.

Preparation Before Starting

Prerequisite: Install and log in to Cursor CLI on the same computer, or use CURSOR_API_KEY instead.

Windows (PowerShell):

irm 'https://cursor.com/install?win32=true' | iex
agent login

macOS / Linux:

curl https://cursor.com/install -fsS | bash
agent login

agent login and cursor_agent must be able to access the Cursor server. Browser proxies or Clash-style system proxies do not automatically apply to terminals; Node.js does not read them. You need to set proxy environment variables in the same window you intend to use:

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:ALL_PROXY = "http://127.0.0.1:7890"
$env:NO_PROXY = "localhost,127.0.0.1"
$env:NODE_USE_ENV_PROXY = "1"

The port depends on your proxy software. After setting, run agent login and start DSH in the same window. This plugin forwards HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY / NODE_USE_ENV_PROXY to the Cursor sub-process, so setting them in the same window is effective. Also note: if your Clash configuration sets node.exe to DIRECT, the sub-process might bypass the proxy, and the Settings page and doctor will indicate this.

Installation and Activation

Install from npm (recommended):

dsh plugin --profile desktop add dsh-cursor-acp

Web interface:

dsh plugin --profile web add dsh-cursor-acp

You can also install from GitHub:

dsh plugin --profile desktop add github:loeanxi/dsh-cursor-acp
dsh plugin --profile web add github:loeanxi/dsh-cursor-acp

After installation, you need to restart DeepSeek Harness. The Node engine requirement is ^22.19.0 || >=24.0.0.

Post-Installation Checks

Open Settings → Cursor subagent, and confirm three things sequentially:

  1. The page detects whether the CLI is found. Note that finding the CLI does not equal being logged in. The page also checks the login status of agent status and whether the current process has HTTPS_PROXY and NODE_USE_ENV_PROXY=1. If not logged in or the proxy is missing, the page will explain. The page does not display the email address.

  2. You can select subtask model parameters (effort, Fast, model) and click Apply. This selection only affects cursor_agent and does not affect the model of the current chat; the selection is stored by the plugin itself and works on the original DSH, independent of Host settings allowlist.

  3. Click the Test button to verify connectivity. It will send a read-only official task (agent --print --mode ask, replying with pong). Test consumes a small amount of Cursor quota and does not start a full ACP session.

How to Use

Simply make a request directly in the chat, for example “Have Cursor implement this feature” or “Have Cursor review this file”. Provide sufficient detail in the message, and the agent will automatically call cursor_agent.

Tasks run in the current workspace folder and use your Cursor subscription quota. The parent chat only sees the final result.

When CLI is Not Found

Run the doctor subcommand to diagnose:

dsh plugin --profile desktop exec dsh-cursor-acp doctor

Use --profile web for the web interface:

dsh plugin --profile web exec dsh-cursor-acp doctor

The doctor command prints the CLI path, login/proxy hints, and whether this dsh can load @deepseek-ai/dsh-subagent-acp / dsh-tool-subagent. If these two official packages are missing, the Settings page will explain, and cursor_agent will not be registered.

Suitable Scenarios and Notes

Suitable for users who have already installed the Cursor CLI locally and have a Cursor subscription, and want the agent in the DSH chat to delegate independent subtasks. The parent chat only receives the final result, making it suitable for handing over tasks with clear boundaries.

Notes before use:

  1. Tasks consume your Cursor subscription quota, and the Test button also consumes a small amount of quota.

  2. Proxy environment variables must be set in the same window you intend to use; browser proxies are ineffective for terminals.

  3. The plugin depends on the official packages @deepseek-ai/dsh-subagent-acp and dsh-tool-subagent. If they are missing, cursor_agent will not be registered.

  4. The plugin runs with the permissions of the current dsh process. Before installing any community plugin, it is recommended to check the source code and license; this plugin uses MIT, and the source code is on GitHub.

Conclusion

To recap: dsh-cursor-acp integrates the locally installed Cursor CLI into the DSH chat workflow—one installation command, one settings page, and one doctor subcommand cover the path from activation to troubleshooting, giving the agent in the chat one more executor to delegate independent tasks to.

  • Directory page: https://www.skillhub.cn/plugins/loeanxi/dsh-cursor-acp
  • GitHub: https://github.com/loeanxi/dsh-cursor-acp

The directory page is a community-maintained independent site and has no official affiliation with DeepSeek or Hypersphere.