Awesome DeepSeek Harness Plugins

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
• Productivity & Agent Workflow
• Context, Memory & Observability
• Tools, Integrations & Automation
• Design & Creative Tools
• Browser, Computer Use & Remote Execution
• Interfaces & Web UI
• Developer Tooling
• Utilities
• Creative & Personal
• Launchers & Clients
• Ecosystem Indexes
• Contributing
• License

Start Here — Official DSH Resources

• DeepSeek Harness - Official source repository; the primary reference for releases, issues, and compatibility.
• Documentation guide - Official documentation portal supplied by the DSH project.
• Run DSH - Start the local Web UI with npx @deepseek-ai/dsh web.
• Architecture - How the plugin-first DSH runtime is structured.
• Capability seams - Extension boundaries for DSH capabilities.
• Cordis primer - Introduction to the underlying composability framework.
• Development guide - Build DSH from source and contribute upstream.
• Defensive patterns - Official guidance for safer extensions.
• Testing - DSH testing approaches.
• Examples - Official headless, JSON-RPC, MCP-memory, scheduled-web, and Cordis examples.
• DeepSeek Harness Discussions - Official feedback and community forum.
• DeepSeek Harness Discord - Community chat linked by the official repository.

Install and Discover Plugins

• GitHub topic: dsh-plugin - The official recommended GitHub topic for DSH plugin repositories.
• Plugin registry - A lightweight repository-plugin console and make-dsh-plugin development guide.
• Plugin workshop - Community plugin-marketplace and registry workshop.

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-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

• dsh-custom-tool - Create and manage sandboxed JavaScript tools with a Monaco-based editor.
• dsh-tool-search - On-demand tool discovery and progressive schema disclosure.
• dsh-ssh - Remote execution, SFTP filesystem, ProxyJump, subprocess, and PTY support over SSH.
• dsh-openmaic - OpenMAIC classrooms, slides, interactive widgets, and Socratic teaching.
• dsh-deep-research - Adaptive deep-research orchestration workflow.
• dsh-openai-codex-auth - OpenAI Codex OAuth login and usage-card integration.
• dsh-plugin-claude-bridge - Bring Claude Code memory, skills, and configuration into DSH.
• dsh-acp-for-bitfun - BitFun and DSH ACP integration.

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.

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

• dsh-tui - Small session-aware terminal UI.
• dsh-cc-tui - Claude Code-style full-screen terminal interface.
• dsh-tianshu-tui - Terminal UI for DSH.
• dsh-grok-tui - Use DSH through grok-build's TUI.
• dsh-focus-chat - Reduced chat view that emphasizes final outputs.
• dsh-working-activity - Live status line for model activity and tools.
• dsh-notification - Desktop notifications for completed turns with outcome and keyword controls.
• dsh-session-notification - Browser and prompt notifications for four session states.
• dsh-deeplink - Open a specified session or workspace directly from a Web UI URL.
• dsh-navbar - Right-edge conversation-node navigation.
• dsh-task-status - Background task progress and live-output status bar.
• dsh-spotlight - Keyboard-first command palette for DSH Web.
• dsh-paste-input - Clipboard paste, drag-and-drop, and file-picker enhancements.
• dsh-input-history - Terminal-style input history navigation.
• dsh-ui-progress - Session progress, generation speed, interruption, and todo indicators.

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.

• awesome-dsh-plugin - Community-curated DSH plugin list.
• awesome-dsh-plugin - Bilingual DSH plugin index.
• awesome-DSH-plugin - Curated DSH extensions and development resources.
• awesome-deepseek-harness - DSH plugins, skills, MCP servers, orchestrators, and UIs.
• dsh-suite - Bilingual directory with daily compatibility CI and a scaffold.
• oh-my-dsh - DSH plugin collection.
• oh-my-dsh - Large DSH extension ecosystem catalog.

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.