DSH Plugin Store
← Back to home

walkinglabs

awesome-deepseek-harness-plugins

A curated, bilingual list of verified plugins, tools, design workflows, and learning resources for DeepSeek Harness (DSH).

Stars
4
Language
—
Created
Aug 13, 2026
Updated
Aug 14, 2026
SkillsIndex
GitHub repo

Introduction

Awesome DeepSeek Harness Plugins Awesome

English | 简体中文

A curated index of plugins, starters, tools, and primary resources for DeepSeek Harness (DSH).

DeepSeek Harness is DeepSeek AI's open-source, plugin-first agent harness: models, tools, skills, sessions, sandboxes, filesystems, loops, orchestration, and UI can all be composed as plugins.

Developer preview — DSH is changing quickly and may introduce breaking changes. This independent community list is not endorsed by DeepSeek AI or walkinglabs. Review source code and pin a DSH version/commit before installing any third-party plugin. 中文说明

flowchart LR
  User["Developer / User"] --> Web["DSH Web UI or CLI"]
  Web --> Runtime["DeepSeek Harness runtime"]
  Runtime --> Agent["Agent loop"]
  Agent --> Model["Model provider"]
  Agent --> Tools["Tools & skills"]
  Runtime -. loads .-> Plugins["Plugins"]
  Plugins --> Tools
  Plugins --> UI["Web UI extensions"]
  Plugins --> State["Sessions, settings & services"]

  classDef core fill:#0b65c2,color:#fff,stroke:#084c94;
  classDef plugin fill:#e6f4ff,color:#083b66,stroke:#4fa3e3;
  class Runtime,Agent core;
  class Plugins,UI,State plugin;

Quick Tutorial — Install DSH and Write Your First Plugin

1. Install and run DeepSeek Harness

Install a current Node.js release, then run:

npx @deepseek-ai/dsh web

Open http://127.0.0.1:3080. In Settings → Models, add a DeepSeek API key; then select a workspace before starting a session. The official Web UI guide explains the next steps.

2. Create a minimal plugin from source

Plugin development currently starts from an official DSH checkout:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
mkdir -p scratch-plugin/src

Create scratch-plugin/src/hello-plugin.ts:

import type { Context } from '@deepseek-ai/cordis'

export const name = 'hello-plugin'

export function apply(ctx: Context) {
  console.log('[hello-plugin] loaded')
}

Then create scratch-plugin/cordis.yml. Replace the path with the absolute path printed by pwd in the DSH checkout:

- insert:
    - id: hello
      name: '/absolute/path/to/deepseek-harness/scratch-plugin/src/hello-plugin.ts'

Run the development overlay:

pnpm dsh web --patch ./scratch-plugin/cordis.yml

When DSH starts, the terminal should show [hello-plugin] loaded. This is the smallest valid DSH plugin: export apply(ctx) and register capabilities through the Cordis context. To add an agent-callable tool, declare export const inject = ['tools'] and register it with the documented DSH tool API. Follow the official first plugin and tool-plugin tutorials for the complete, current API.

3. How the plugin mechanism works

flowchart TD
  Overlay["cordis.yml overlay"] -->|loads| Module["Plugin module"]
  Module --> Contract["name · inject · apply(ctx, config)"]
  Contract --> Inject["inject: wait for required services"]
  Contract --> Config["Config schema: validate settings and defaults"]
  Contract --> Apply["apply: register capabilities"]
  Apply --> Capabilities["Tools · commands · events · UI · services"]
  Capabilities --> Runtime["Cordis / DSH runtime"]
  Runtime --> Effects["Lifecycle-managed effects"]
  Effects --> Cleanup["Unload or HMR: registrations are cleaned up"]

DSH is built on Cordis, a runtime composition framework. A plugin is not merely an npm dependency: it is a module that DSH loads into a live context. The plugin declares a name, optionally declares inject dependencies such as ['tools'], and exports apply(ctx, config). Cordis waits until injected services are ready, validates any exported Config schema and defaults, then invokes apply.

Inside apply, the plugin can register a tool for the agent, a human command, a settings schema, event listeners, Web UI components, or a service for other plugins. Registrations are lifecycle-managed effects: on unload or hot replacement after a config edit, Cordis removes old registrations automatically. Use ctx.effect() only when your plugin owns a resource needing explicit cleanup, such as a timer or network connection. See the official configuration guide, service guide, and capability seams.

4. What this awesome list includes

flowchart TB
  Discover["GitHub discovery\n(recent public candidates)"] --> Verify["Source-level DSH verification"]
  Verify -->|"Manifest/package + documented DSH seam"| Plugin["Verified DSH plugin"]
  Verify -->|"Explicit, inspectable DSH integration"| Resource["Client, launcher, example, or dev resource"]
  Verify -->|"Topic/name/claim only"| Exclude["Excluded\n(not a DSH plugin)"]
  Plugin --> List["Plugin categories in this list"]
  Resource --> List
  List --> Daily["Daily review\nOnly real changes are committed"]

The list distinguishes verified DSH plugins from useful but non-plugin resources such as launchers, clients, and ecosystem directories. See the full inclusion policy for the evidence required before a new entry is added.

5. One runtime, different compositions

DSH profiles are plugin compositions rather than separately maintained products. The official base bundle includes model adapters, tools, persistence, sandbox and approval policy, settings, credentials, and telemetry; Web and headless bundles add different entry surfaces. An agent preset can then give a session a different capability set.

flowchart TB
  Base["dsh-base\nmodels · tools · persistence · sandbox\napproval · settings · telemetry"]
  Base --> WebProfile["Web profile\nbrowser application"]
  Base --> HeadlessProfile["Headless profile\none-shot runner"]
  Base --> Preset["Agent preset\nper-session capability composition"]
  Preset --> Loop["Agent loop"]
  Preset --> Toolset["Toolset"]
  Preset --> Providers["LLM / filesystem / subagent providers"]
  Preset --> Policy["Permission & sandbox policy"]

This makes a “mode” primarily a selected plugin graph and policy set. It does not guarantee that every composition is stable or suitable for every task; DSH is still a developer preview.

6. Tool calls use one guarded execution pipeline

flowchart LR
  Call["Model emits tool call"] --> LoggedCall["Log tool/call"]
  LoggedCall --> Pre["tools/pre-execute\nhooks · permission · sandbox"]
  Pre --> Ask{"Approval needed?"}
  Ask -->|approved| Guards["Monotonic guards"]
  Ask -->|denied / unavailable| Denied["Skip tool body"]
  Guards --> Execute["tools/execute\ntimeout · retry · metrics"]
  Execute --> Body["Tool execute()"]
  Body --> Post["tools/post-execute\naccept · block · replace"]
  Denied --> Post
  Post --> Result["Finalize & log tool/result"]
  Result --> UI["UI result card"]
  Result --> Next["Next model request"]

Plugins can insert policy, observability, timeout, or result-handling behavior at documented stages without editing the Agent Loop. The official pipeline also routes Code Mode's dispatched sub-calls through this same path, preserving the approval, sandbox, and logging boundaries.

7. Agent turns, steps, and the append-only session log

sequenceDiagram
  participant U as User
  participant A as Agent loop
  participant P as Prompt assembler
  participant M as Model
  participant T as Tool pipeline
  participant L as Append-only session log
  U->>A: followup(message)
  A->>L: turn/start + user/message
  A->>P: assemble prompt sections + tool schemas
  P->>M: request
  M-->>L: assistant/chunk*
  M-->>L: assistant/message
  M->>T: tool/call*
  T-->>L: tool/result*
  A->>L: step/end
  alt more input or tool results are owed
    A->>P: next step
  else no pending work
    A->>L: turn/end
  end

The session log is the model-context source of truth: durable events record turns, messages, tool calls/results, and raw stream chunks. Forking, resuming, replay, transcripts, telemetry, and persistence derive from that stream; model-visible content must be reconstructable from it.

8. Multi-agent and workflow extension points

flowchart TB
  Parent["Parent agent\nplans, delegates, aggregates"] --> Subagent["Subagent capability seam"]
  Subagent --> Fresh["Fresh child agent"]
  Subagent --> Fork["Forked / continued session"]
  Subagent --> External["External product provider\n(e.g. ACP-backed)"]
  Parent --> Workflow["Workflow capability"]
  Workflow --> Parallel["Parallel branches"]
  Workflow --> Pipeline["Pipeline stages"]
  Workflow --> Background["Background work"]
  Fresh --> Events["subagent/* + session/event"]
  Fork --> Events
  External --> Events
  Workflow --> Events
  Events["Durable session events + live agent events"] --> Inspect["UI, trajectory, replay, telemetry"]

DSH provides a hierarchy-oriented delegation surface and workflow components; providers behind the subagent seam can vary. The key architectural point is replaceability and shared observability, not a claim that DSH has invented a new multi-agent paradigm.

Contents

Start Here — Official DSH Resources

Install and Discover Plugins

Curation policy

The dsh-plugin topic, a dsh- repository name, or a README claim alone is not enough for an entry in this list. Every new plugin must meet the source-level verification policy in INCLUSION_POLICY.md: a real DSH plugin manifest/package or a verifiable, official DSH extension seam. Discovery runs daily over projects from the previous 48 hours; candidates also undergo static security triage of scripts, dependencies, entrypoints, workflows, and sensitive operations. Only candidates that pass both checks are added. This is not a complete security audit or a compatibility guarantee.

Productivity & Agent Workflow

  • dsh-worktree - Permanent Codex-style Git worktrees, agent tools, /worktree, and per-repository manifests.
  • dsh-at-file - Codex-style @file mentions that search a workspace and attach file contents to prompts.
  • dsh-open-in-vscode - Open a DSH workspace directly in VS Code from the Web UI.
  • dsh-plannotator - Anchored plan annotations and structured agent feedback.
  • dsh-daily-progress - Daily-progress workflow plugin.
  • dsh-revive - Resume interrupted sessions with a command, tool, and browser control.
  • dsh-book2skill - Five-stage book-to-skill workflow with human approval gates.
  • dsh-loop - Scheduled loops with a /loop command, tool, and activity bar.
  • dsh-automation - Run coding tasks in fresh agent sessions on a schedule.
  • dsh-agent-teams - AgentTeams integration for DSH.
  • dsh-interconnect - Cross-instance message and event handoff service plus tools.
  • dsh-turn-rewind - Restore conversation and workspace state through a persistent change ledger.
  • dsh-undo - Context undo/redo around the last completed agent step.
  • dsh-openbiliclaw - OpenBiliClaw client integration with recommendation and agent-bridge tools.

Context, Memory & Observability

  • dsh-compaction-instant - Offline, deterministic replacement for DSH's basic compaction seam, with recall tools for the append-only session log.
  • dsh-memory-evolve - Cross-session memory, branch awareness, session search, and self-evolving skills.
  • Nowledge Mem for DSH - Community memory-plugin bundle built around Nowledge Mem.
  • dsh-session-search - Index-free cross-agent session search.
  • dsh-session-health - Read-only diagnostics for multi-frame zstd session files.
  • dsh-postmortem - Local-first failure postmortems for DSH sessions.
  • dsh-context-doctor - Audit instruction, skill, and tool-schema token cost, duplication, and conflicts.
  • dsh-trace - Export DSH turns, model steps, and tool calls to yiTrace over HTTP.
  • dsh-sentinel - Durable file, command, HTTP, process, and webhook watches that wake an agent.
  • dsh-explain - Local-first learning mode with global learning threads and explainable context.

Tools, Integrations & Automation

Design & Creative Tools

DSH design plugins can connect an agent's planning and tool use to visual inspection, canvas editing, generated UI, and image workflows. As with every listing here, install only after reviewing the source and its permissions.

flowchart LR
  Brief["Design brief\nor source change"] --> Agent["DSH agent"]
  Agent --> Vision["Visual understanding\nimage · OCR · UI grounding"]
  Agent --> Canvas["Design canvas\npreview · edit · inspect"]
  Agent --> GenUI["Generated UI\ncomponents · charts · forms"]
  Vision --> Feedback["Structured visual feedback"]
  Canvas --> Feedback
  GenUI --> Feedback
  Feedback --> Agent
  Agent --> Output["Updated design, code, or artifact"]
  • dsh-openpencil - OpenPencil integration with multi-frame previews, an interactive canvas, and managed editor workbenches.
  • dsh-genui - Render interactive components, charts, forms, Mermaid, and 3D scenes inline in replies with an action loop back to the agent.
  • dsh-web-review - Web preview and element annotation feedback for source editing.
  • dsh-vision-toolkit - Image Q&A, OCR, UI restoration, grounding, pixel diffs, and visual artifacts for DSH.
  • dsh-ernie-image - DSH image-generation integration packaged with a DSH bundle patch.
  • dsh-visualize - Inline interactive HTML cards rendered in a sandboxed iframe with a constrained CSP and workspace export.
  • dsh-image-to-path - Same-origin, size- and magic-byte-checked image paste/drop uploads saved under the active session workspace.

Browser, Computer Use & Remote Execution

  • ego-browser - Chromium agent browser with semantic snapshots, controls, screenshots, CDP, and isolated workspaces.
  • dsh-browser - Chrome sidebar extension for direct browser operation without vision capabilities.
  • dsh-better-browser - Signed-in browser access through Kimi WebBridge tools.
  • dsh-computer-use - Accessibility-first macOS computer-use bundle with scoped permissions and freshness checks.

Interfaces & Web UI

Developer Tooling

  • dsh-plugin-skills - Agent skills for scaffolding and testing DSH plugins.
  • dsh-plugin-dev - Practical plugin-development notes on Cordis, TypeScript, Windows junctions, and sessions.
  • dsh-plugin-check - Read-only plugin repository health checks for manifests, patches, and build pitfalls.
  • dsh-security-audit - Read-only local audit of configuration, plugin provenance, sessions, and network exposure.
  • dsh-scout - Read-only environment discovery: software, resources, ports, services, hardware, and workspace.
  • dsh-bash-encoding - Better decoding for UTF-16LE, UTF-8, GBK, and other Bash output encodings.
  • dsh-tool-approval - Manual/ask-mode approval for DSH tools.

Utilities

  • dsh-toolkit - Zero-dependency collection for time, encoding, JSON, calculation, CSV, regex, Markdown, diff, statistics, and schema tools.
  • dsh-tool-time - ISO 8601, IANA timezone, UTC-calendar, and duration utilities.
  • dsh-tool-json - Zero-dependency JMESPath-subset JSON querying.
  • dsh-tool-schema - JSON Schema validation, path inspection, explanations, and normalization.
  • dsh-tool-regex - Safe regex testing, extraction, replacement, and static explanation.
  • dsh-tool-csv - RFC 4180 parsing, querying, statistics, and conversion.
  • dsh-tool-markdown - HTML/Markdown conversion, GFM table normalization, and table-of-contents generation.
  • dsh-tool-diff - Structured text, JSON, CSV, and Markdown comparisons.
  • dsh-tool-stat - Descriptive statistics, percentiles, distributions, and correlation.
  • dsh-tool-calculator - Safe mathematical-expression evaluator.
  • dsh-tool-encoding - Base64, URL, hex, hash, and UUID utilities.

Creative & Personal

  • dsh-annotation - Select text, attach annotations, and send structured feedback with a message.
  • dsh-prompt-studio - Edit user and system-prompt sections with live preview.
  • dsh-ui-whale - Animated pixel-whale companion for the Web UI.
  • whale-girl - Config-installable desktop-pet repository plugin.
  • dsh-pet-corner - Floating pet, image proxy, favorites, and plugin-owned settings.
  • dsh-fun-weather - Open-Meteo weather tab and weather-following themes.
  • dsh-fun-ticker - Configurable crypto, FX, A-share, index, and stock ticker.
  • dsh-fun-typewriter - WebAudio typing ambience with plugin settings.
  • dsh-minigames - Offline side-panel mini-games for wait time.

Launchers & Clients

  • dsh-launcher - Lightweight Windows autostart launcher with a minimal WebView2 window.
  • dsh-launcher - Portable Windows one-click launcher without a Node.js setup.
  • DSHgo - Windows desktop launcher and profile manager.
  • dsh-desktop - Electron desktop client with workspace, session-sharing, remote, and tray support.
  • orbis - Mobile remote-control client for DeepSeek Harness.
  • oh-dsh-desktop - Extensible macOS workbench with native PTY, workspace tools, and isolated preview marketplace.

Ecosystem Indexes

These are community indexes rather than individual plugins; use them as secondary discovery sources and verify entries yourself.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

To the extent possible under law, the maintainers have waived all copyright and related rights to this work under CC0 1.0.