Awesome DeepSeek Harness [](https://awesome.re)
August 16, 2026 · View on GitHub
DeepSeek Harness (dsh) is an open-source agent harness by DeepSeek AI where every part is a plugin, built on the Cordis meta-framework.
Contents
- Quick start
- Official resources
- Documentation
- Core concepts
- Packages
- Community plugins
- Write-ups
- Related lists
Quick start
npx @deepseek-ai/dsh web
Requires Node.js. Starts the Web UI at http://127.0.0.1:3080.
To run from source:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
Official resources
- Repository - Source code, issues, and releases.
- README.zh - Chinese README.
- Discord community - Official Discord server.
- GitHub Discussions - Feedback and bug reports.
- WeCom group survey (Chinese) - Entry form for the official WeCom group.
dsh-plugintopic - Plugin repositories tagged for discovery.- AGENTS.md - Rules for agents working on the repository.
- CONTRIBUTING.md - How to contribute upstream.
- THIRD_PARTY_NOTICES.md - Third-party dependency licenses.
Documentation
Paths are relative to docs/ in the main repository. Most files have a .zh.md counterpart.
- Architecture - Plugin tree, profiles and bundles, turn flow, session log, and capability seams.
- Cordis primer - Introduction to the underlying plugin framework.
- Cordis tutorial - Step-by-step Cordis tutorial.
- Development guide - How to develop against the repository.
- Web UI guide - Using the Web UI.
- Python SDK guide - Bundled Python SDK.
- Agent lifecycle - Turn and step sequence.
- Tool execution pipeline - How tool calls run.
- Capability seams - Swappable capability model.
- Event producer/consumer map - Every event and its producers and consumers.
- Config catalog - Configuration fields.
- Tool catalog - Built-in tools.
- Persistence catalog - Storage layout.
- Extension cookbook - Recipes for extending dsh.
- Testing - Test practices.
- Glossary - Terminology.
Core concepts
- Everything is a plugin: the model adapter, tool registry, session log, sandbox and approval policy, agent loop, and Web UI are all plugins on Cordis.
- Profiles, bundles, and patch layers compose the boot tree;
dsh --profile web --dump-configprints the tree a machine actually boots. - Event-sourced session log: an append-only
SessionEventstream with a runtime invariant that anything model-visible is reconstructable from the log. Replay, fork, resume, transcripts, and telemetry derive from it. - Capability seams have three roles: service definition, provider, and consumer. Swapping a provider moves a whole capability, for example Bash, PTY, and LSP to a remote sandbox together.
- Agent presets are per-session compositions. Built-in presets:
minimal,standard,code, andcordis.
Packages
- @deepseek-ai/dsh - CLI, profile boot, plugin management, and browser UI alias.
- @deepseek-ai/dsh-web-app - Browser surface bundle.
- @deepseek-ai/dsh-headless - One-shot runner with no HTTP layer.
- @deepseek-ai/dsh-frontend - Built frontend distribution.
Community plugins
- 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.
- zhu1090093659/dsh-web-ui - Web UI skins and panels: task board, Git graph, side panels, mobile UI, and token stats.
- bowenliang123/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.
- Anionex/dsh-vision-toolkit - Vision features for text-only models: image Q&A, long-screenshot OCR, and UI grounding.
- ccch1mneyyy/dsh-cc-tui - Fullscreen terminal UI in Claude Code style.
- huiliyi37/dsh-tianshu-tui - Terminal UI for DeepSeek Harness.
- Nwflower/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.
- slywalker2006/dsh-passwords - Login gateway for the DSH web UI: first-run setup, multi-user accounts, bcrypt encryption, brute-force lockout, audit log, and automatic HTTPS.
Write-ups
- 首发体验 | DeepSeek Harness 来了,它不想做下一个 Codex - iFanr hands-on review (Chinese).
- 对标 Claude Code:DeepSeek Harness 公测,同步开放 npm 插件生态 - ITHome news (Chinese).
- DeepSeek Harness 即将公测,模型厂商的 Agent 框架是怎么造的 - SegmentFault architecture explainer (Chinese).
- DeepSeek 为什么必须做 Harness - 163 analysis (Chinese).
Related lists
- Awesome DSH Plugins - Plugin directory with daily compatibility tracking.
- Awesome DeepSeek Harness - Curated plugins, tools, and infrastructure.
- Awesome - The main list of awesome lists.
Contributing
See contributing.md.
Footnotes
- Unofficial community list, not affiliated with DeepSeek.
- DeepSeek Harness is in developer preview with compatibility-breaking changes; links point at the
masterbranch. - Community plugin snapshot collected on 2026-08-13.