Introduction

In the DeepSeek Harness (DSH) plugin ecosystem, many capabilities can be accessed via plugins. dsh-agent-sync addresses a specific repetitive task: if other AI agents on the local machine already have MCP servers and Skills configured, and you want to continue using them in DSH, you currently have to transfer them one by one.

dsh-agent-sync discovers these MCP servers and Skills by scanning the real configuration of AI agents on the local machine and writes them into DSH’s profile or workspace. Below is an introduction to its capabilities, installation method, and typical usage.

What is it

dsh-agent-sync is a DSH plugin maintained by kuaiyukuaikuai under the MIT license.

It targets MCP servers and Skills for 20+ AI agents, providing synchronization, management, manual addition, migration, filtering, and model tool calling.

Core Capabilities

Scan and Sync

The plugin can automatically scan the real configuration of installed AI agents on the local machine and discover MCP servers and Skills.

When synchronizing, it:

  • One-click writes MCP servers into the cordis.patch.yml of each profile and instantiates them as @deepseek-ai/dsh-mcp-client instances.
  • One-click copies or links Skills to the global $DSH_HOME/skills or workspace <workspace>/.dsh/skills.

MCP and Skills Management

The plugin provides MCP/Skills management capabilities, including:

  • Enable/Disable.
  • Delete.
  • Group by global and workspaces.
  • Migrate or copy Skills between global and workspaces.
  • Create Skill groups, bind skills, and filter by group.
  • View Skill details and the content of SKILL.md.

Manual addition also supports two types of objects:

  • MCP: stdio / streamable-http.
  • Skill: folder / single .md / .zip / drag & drop.

Sync Configuration

Configuration can be done in settings:

Skill Sync Method: copy / link/junction
MCP Sync Target: all / desktop / web profiles

Enabling/disabling synchronized items also has different effects:

  • When disabling an MCP, the item is removed from the corresponding profile patch.
  • When disabling a Skill, SKILL.md is renamed to SKILL.md.disabled and can be restored.

Model Tools

The plugin provides the following model tools:

agent_sync_scan
agent_sync_do
agent_sync_status
agent_sync_config
agent_sync_add_skill
agent_sync_toggle
agent_sync_remove
agent_sync_sources

Where:

  • agent_sync_scan is used to view items that can be synchronized.
  • agent_sync_do is used to execute synchronization.
  • The result of agent_sync_scan hides env values and only displays keys.

Extension

The plugin supports extending new agents via AGENT_DEFS.

Installation and Activation

Environment Requirements

  • Node.js ≥ 22.5.
  • Agents that need to be synchronized must be installed on the same machine.
  • The plugin does not come with these agents.

Install to Profile

Enter the target profile directory:

cd "$DSH_HOME/profiles/<name>"

Then install the plugin:

pnpm add dsh-agent-sync

You can also install from GitHub:

pnpm add github:kuaiyukuaikuai/dsh-agent-sync

After installation, restart DSH.

Manually Write Configuration Line

You can also append a line to insert configuration in $DSH_HOME/profiles/<name>/cordis.patch.yml:

- insert:
    - id: dsh-agent-sync
      name: 'dsh-agent-sync'

Save and restart DSH.

MCP synchronization writes into the dsh-agent-sync managed section of each profile’s cordis.patch.yml and fixes it if the file is invalid.

Typical Usage

Synchronize using GUI

Open:

Settings → MCP/Skills

Then select the source to synchronize, choose Select All or custom targets. The target can be global or a specific workspace. Confirm to execute synchronization.

Manually Add Skill

In the Add Skill dialog, you can select:

folder / single .md / .zip

You can also drag and drop the above objects into the dialog and select the target scope.

Configure Sync Parameters

Configure in the settings dialog:

Skill Sync Method: copy / link/junction
MCP Sync Target: all / desktop / web profiles

These parameters will affect the location and method of subsequent Skill and MCP synchronization.

Call Model Tools

First use agent_sync_scan to view items that can be synchronized:

agent_sync_scan

After confirming the objects to synchronize, execute:

agent_sync_do

Applicable Scenarios and Notes

Who is it for

Suitable for developers who use multiple AI agents on the same machine and wish to bring existing MCP servers and Skills into DSH.

Notes

  • The plugin runs with the permissions of the current DSH process; check the source code and license before installing.
  • Agents that need to be synchronized must be on the same machine; the plugin does not come with these agents.
  • When disabling a Skill, SKILL.md is renamed to SKILL.md.disabled and can be restored.
  • The result of agent_sync_scan hides env values and only displays keys.
  • Supports Windows / macOS / Linux, with home-relative paths.

Related Links

Project Repository:

https://github.com/kuaiyukuaikuai/dsh-agent-sync