walkinglabs / awesome-deepseek-harness-plugins

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
• Games & Play
• 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-file-claim - File claim/release protection for parallel DSH sessions in one workspace, with stale-heartbeat takeover and a pending three-way-merge area.
• 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.
• dsh-chat-import - Import full-fidelity conversation histories from 13 coding agents (Claude Code / Codex / ChatGPT / Cursor / Gemini / Reasonix / opencode / ZCode / Grok Build / OpenClaw / Pi / Hermes / Kimi) as resumable DeepSeek Harness sessions, with reverse export/sync back to Claude Code.

Context, Memory & Observability

• dsh-context-proxy - On-demand context_query, context_slice, and context_grep tools over persisted session history, using the official session-query and subprocess seams.
• co-engram - Self-evolving team memory as plain Markdown in git: 38 bare-name memory tools on ctx.tools plus a memory:co-engram prompt section re-evaluated at every assembly; ships a dsh.bundle manifest so dsh plugin add @co-engram/dsh activates with zero manual config; process-lock coexistence with its Claude Code (MCP) and OpenClaw hosts; verified against DSH 0.1.0-rc.6.
• dsh-compaction-instant - Offline, deterministic replacement for DSH's basic compaction seam, with recall tools for the append-only session log.
• dsh-continual-evolve - Versioned, auditable, rollback-safe harness state (prompt notes, memories, skills, subagent specs) refined from session trajectories; verified against DSH 0.1.0-rc.6.
• dsh-cost-meter - Per-session and daily API cost, budget, and official-balance tracking for the DSH Web UI, with a history dashboard and one-click official price sync (built against the current dsh web bundle).
• 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 - Context insight panel: see what the model's context window is made of and how it evolves — composition vs. window size, per-request history, compression/injection events, and per-message token stats.
• 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.
• dsh-telemetry-redactor - Redacts supported secret patterns from the exported session-telemetry/record copy without changing the canonical session log; audited against DSH commit 47f943859bef60e4160492346772ded9b24f765a and tested with dsh-session-telemetry rc.6.
• dsh-verification-receipt - Writes local JSONL summaries of per-turn tool outcomes and heuristic verification signals without storing prompts, tool arguments, or result text; audited against DSH commit 47f943859bef60e4160492346772ded9b24f765a and tested with dsh-session rc.6.

Tools, Integrations & Automation

• dhicoc/dsh-reverse-skill - Complete reverse-skill pack (85 SKILL.md) as a DeepSeek Harness Cordis plugin: reverse engineering, authorized pentesting and security-research skill router.

• 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-figma-to-lottie - Compile SVG paths and keyframe data into self-contained Lottie JSON animation files.
• 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

• Tabbit Browser for DSH - Browser-automation skill with an explicit tool that can download the region-appropriate Tabbit Browser installer when the supported browser is absent or outdated.
• 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-reasoning-effort - Codex-style session model and reasoning-effort selector that follows adapter-advertised levels, with read-only guidance for custom-provider declarations.
• dsh-passwords - Login gateway for remote, multi-user DSH Web access, with HTTPS, quotas, sandbox restrictions, and audit logs.
• dsh-ux-simple - A two-mode Web UI that provides plain-language tool-call cards while preserving the native view.
• dsh-any-background - Local-browser theme color, wallpaper, opacity, and blur customization for DSH Web.
• 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-bell-notify - Per-lifecycle-event chimes for DSH (startup, tool call, command, approval wait, turn complete, idle) synthesized live with Web Audio — zero audio files — plus a breathing status dot; declarable via a dsh.bundle manifest with a Cordis patch.
• 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-sticky-disclosure - One-click collapse of every expanded section in the Web UI (Think rows, tool cards) with a live count and a customizable hotkey. Compatible with DSH 0.1.0-rc.6.
• 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-fail-logger - Deduplicates failed native, Code Mode, and inline tool calls into a locally maintained skill section; supported secret patterns are redacted before persistence.
• dsh-reviewer-bot - Configurable DSH-native code-review bundle for GitHub and GitLab, with fail-closed write mode and local replay support.
• dsh-auto-mode - Fail-closed automatic-permission policy with protected-path and credential checks, plus redacted classifier fallback for ambiguous tool calls.
• Code2Skill - DSH bundle of three skills that generate and review Function, MCP, and Agent Skill packages from authorized source code (version-pinned at v1.1.3).
• 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-rtk - Routes eligible bash commands through rtk (Rust Token Killer) inside the DSH bash executor to compress tool output and save tokens; safe passthrough when rtk is absent.
• 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-toy - Control compatible personal devices through Intiface or MonsterParty; the optional Intiface helper downloads a pinned, SHA-256-verified upstream engine when absent.
• 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.

Games & Play

• dsh-minigames - An offline DSH Web side panel with 18 mini-games, including Dino, Tetris, Tanks, Gomoku, and Minesweeper.

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.