DeepSeek Harness (dsh)

An open-source agent harness from DeepSeek AI where everything is a plugin.

Stars
★ 254k
Last updated
2d ago
License
MIT
Primary language
TypeScript

At a glance

How it runs
CLIWeb app
Works with
Universal · cross-platform
Cost
Free software; you pay for model usage
Setup effort
Low · running in minutes
You'll need
Node.jspnpmShell / CLINetwork access
Typical use
Developers who want to build custom agents with a plugin-driven architecture and interact via a Web UI.
Not a fit if
  • Teams needing stable APIs and long-term compatibility; this is a developer preview with breaking changes
Source review
65/100 · Some gaps

What does this agent do, and when should you use it?

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI, built on a plugin-first architecture powered by Cordis, whose design is described in the paper "A Programming Paradigm for Spatiotemporal Composability". Currently in developer preview, it evolves rapidly with breaking changes. It can be run via npm or from source, providing a default Web UI at http://127.0.0.1:3080. The project is MIT-licensed and encourages community involvement through GitHub Discussions and Discord.

dsh provides a plugin-based runtime for building and interacting with agents. It starts a Web UI server with the command npx @deepseek-ai/dsh web (or pnpm dsh web from source). The Web UI allows users to manage and interact with agents through a browser interface. Its plugin system enables extensibility; community developers can publish plugins with the dsh-plugin topic for discoverability. It leverages Cordis for composability and supports a modular architecture where all components are plugins.

  1. Developers who want to build custom agents with a plugin-driven architecture and interact via a Web UI.
  2. Researchers interested in the Cordis design paradigm and seeking a flexible harness for experiments.
  3. Community members who want to publish and share agent plugins with a dedicated topic tag.
  4. Organizations that prefer self-hosted, open-source agent frameworks with permissive licensing and commercial viability.

How do you install or deploy this agent?

  1. Install Node.js. 2. Run npx @deepseek-ai/dsh web to start the Web UI.

How do you use this agent?

After installation, open http://127.0.0.1:3080 in a browser to use the Web UI. For source-based setup: git clone https://github.com/deepseek-ai/deepseek-harness.git && cd deepseek-harness && pnpm install && pnpm run build && pnpm dsh web.

What are this agent's strengths and limitations?

Pros
  • Plugin-first architecture powered by Cordis offers high extensibility and composability.
  • Web UI provides an accessible interface for interaction and management.
  • MIT license allows broad usage, modification, and commercial adoption.
Limitations
  • Developer preview status implies frequent breaking changes, unsuitable for production.
  • Documentation is limited; installation and usage rely primarily on the README and community support.
  • Requires Node.js (and pnpm for source builds), adding runtime dependencies.

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
DeepSeek Harness (dsh) This agent 65 · Some gaps CLIFree + model costs ★ 254k 2d ago TypeScript —
Codemini CLI 71 · Some gaps CLIFree + model costs ★ 35 1mo ago JavaScript OpenAI API · Claude API
CLI Agent Orchestrator 65 · Some gaps CLIFree + model costs ★ 1.5k today Python Codex · Claude Code
Designing Multi-Agent Systems (PicoAgents) 59 · Major gaps Library / SDKFree + model costs ★ 1.4k 1mo ago Python OpenAI API · Claude API

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Some gaps
65/ 100 5-point scale 3.3 / 5
Trust 17/29
Reliability 9/14
Adaptability 12/18
Convention 13/18
Effectiveness 9/13
Verifiability 5/8
Why each dimension lost points
Trust17 / 29 · 2.9/5

Evidence shows: CI workflows explicitly set DSH_TELEMETRY_DISABLED=1 to prevent telemetry reporting, and web config rejects --host 0.0.0.0 to avoid remote code execution exposure, reflecting least privilege. User confirmation: no explicit user confirmation mechanism found, but config patches and hot reload may imply user actions. Data flow transparency: tests verify credentials not leaked to stdout/stderr, and config dump feature exists. Sensitive data handling: tests verify credential file permissions 0600 and Bearer token in request headers. Dependency security: uses pnpm lockfile and frozen install, but no vulnerability scanning evidence. External effects: tests verify network requests only to mock server, and telemetry disabled. Rollback: tests verify config reverts to default after patch removal. Source attribution: no explicit source attribution mechanism found, but third-party notices generation script exists. Deductions: user confirmation mechanism unclear, dependency vulnerability scanning evidence missing, source attribution unclear.

Reliability9 / 14 · 3.2/5

Evidence shows: tests cover argument parsing, lifecycle, hot reload, etc., and CI has multiple platforms and node versions, indicating good self-consistency. Dependency availability: uses pnpm workspaces and lockfile, but not all dependencies' availability verified. Failure messages: tests verify error messages contain specific info, e.g., '--host 0.0.0.0 is intentionally not supported yet for safety'. Deductions: dependency availability not fully verified, failure message coverage limited.

Adaptability12 / 18 · 3.3/5

Evidence shows: supports multiple profiles (web, headless, tui, etc.), and tests cover different scenarios, indicating clear audience and scenarios. Capability boundaries: web config rejects wildcard host, indicating boundary control. Trigger precision: argument parsing tests verify precise routing. Environment fit: CI covers Linux, Windows, macOS, and multiple Node versions. Deductions: no explicit audience documentation found, capability boundary description limited.

Convention13 / 18 · 3.6/5

Evidence shows: README and bilingual translation pairing record exist, information architecture clear. Install notes: package.json has install scripts and postinstall. Naming stability: version 0.1.0-rc.5 indicates pre-release. Examples and FAQ: tests have examples, but no FAQ found. Known limitations: no explicit known limitations document found. License: MIT license clear. Versioning changelog: no CHANGELOG found, but version numbers exist. Maintenance responsibility: CI and release scripts indicate clear maintenance responsibility. Deductions: missing FAQ, known limitations, and CHANGELOG.

Effectiveness9 / 13 · 3.5/5

Evidence shows: output usability: tests verify output format and content. Marginal value: plugin architecture and multiple profiles provide additional value. Cost benefit: CI and test coverage indicate reasonable investment. Deductions: no explicit performance or resource usage evaluation found.

Verifiability5 / 8 · 3.1/5

Evidence shows: tests and CI provide verifiable evidence. Claim traceability: tests and documentation linked. Cross-source corroboration: CI and tests corroborate each other. Fact-inference separation: tests clearly distinguish expected and actual. Deductions: no independent third-party verification found.

Risks and how to mitigate them
  • No explicit user confirmation mechanism found, which may affect user informed consent for sensitive operations.
  • No vulnerability scanning evidence found for dependencies, recommend checking dependency vulnerabilities.
  • Missing FAQ, known limitations, and CHANGELOG, which may affect user understanding and maintenance.
Evidence confidence: Low Reviewed Aug 14, 2026 Reviewed revision 47f943859bef New commits since this review; the score may not cover them
See the full review method →

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. dsh-v0.2.1-rc.2 v0.2.1-rc.2 Pre-release
    Release notes excerpt
    [中文](#cn-v0.2.1-rc.2-community) | [English](#en-v0.2.1-rc.2-community) <h3 id="cn-v0.2.1-rc.2-community">新增功能</h3> - 适配 DeepSeek-V4.1-Flash-1017 上线 @LegGasai - 适配 DeepSeek Search 与 Fetch API,可在网页搜索设置中开启 @yudshj, @LegGasai <h3 id="en-v0.2.1-rc.2-community">New Features</h3> - Add support for DeepSeek-V4.1-Flash-1017. by @LegGasai - Add support for DeepSeek Search and Fetch APIs, which can be enabled in Web Search settings. by @yudshj, @LegGasai Full Changelog: [dsh-v0.2.1-rc.1...dsh-v0.2.1-rc.2](https://github.com/deepseek-ai/deepseek-harness/compare/dsh-v0.2.1-rc.1...dsh-v0.2.1-rc.2)
    View on GitHub ↗

FAQ

Is dsh production-ready?
No, it is in developer preview with breaking changes; avoid production use.
How can I extend dsh?
Build plugins and tag your repository with dsh-plugin for discoverability, following the contribution guide.
What are the licensing terms?
The project is MIT-licensed, permitting free use, modification, and commercial distribution.
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents