BetaEditorial Listing

DeepSeek Harness

DeepSeek · DeepSeek Harness: Open-Source, Plugin-Based Agent Harness from DeepSeek

Open DeepSeek Harness

DeepSeek Harness (`dsh`) is DeepSeek's open-source (MIT) agent harness. It runs on your machine as a local web UI where an agent reads and edits workspace files, runs commands, delegates to subagents, and calls MCP tools. It suits developers who want a hackable coding agent built around DeepSeek models, and it is still a developer preview.

PricingFree
Setupmedium
Runs onSelf-hosted · API
APIYes
Open sourceYes
DocsYes
CategoryCoding
Agent HarnessOpen SourceDeepSeekPluginsMCPLocal Web UIDeveloper Preview

Best for

Developers who want an open-source, DeepSeek-native agent harness they can inspect and extend with plugins, and who are comfortable running preview software in an isolated environment

Not ideal for

Teams that need a stable, security-reviewed coding agent for production repositories, users who want to sign in with an existing Codex or other OAuth subscription, and anyone who wants a hosted cloud agent

Who it's for

Developers and researchers who want to run, inspect, and extend an open-source agent harness from DeepSeek

Capabilities

  • Local web UI started with `npx @deepseek-ai/dsh web`, or run from source with pnpm
  • Agent reads and edits workspace files, runs commands, delegates to subagents, and maintains a plan, with approval prompts governed by a permission policy
  • Everything-is-a-plugin runtime on Cordis: models, tools, skills, sessions, sandboxes, storage, loops, scheduling, and UI are swappable plugins configured through YAML profile patches
  • DeepSeek API by default, plus built-in providers such as Anthropic, OpenAI, Moonshot AI (Kimi), and Z.ai (GLM), and custom endpoints using OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages
  • MCP client for stdio and Streamable HTTP servers, with discovered tools exposed to the agent
  • Headless one-shot runs, an ACP profile for editors, a JSON-RPC SDK profile, and a Python SDK (`deepseek-harness-sdk`)
  • Append-only session logs that record system prompts, tool calls, and context injections
  • Experimental Browser Use, Computer Use, and Auto review mode, plus web sidebar terminals and side-by-side file diffs
  • Scheduled reminders (one-off, interval, daily, weekly, or cron) and an opt-in GitHub webhook overlay, shipped as an example configuration, that starts a read-only review session when a pull request is marked ready for review

Limitations

  • Developer preview: the README warns of compatibility-breaking changes, and every release so far is a 0.1.x alpha or release candidate
  • DeepSeek's safety notice says it has not been security audited and is not production-ready. Sandboxing and approval prompts do not guarantee isolation, and it recommends a disposable VM or container
  • Browser Use, Computer Use, and Auto review are marked experimental
  • Providers that sign in with OAuth, such as Codex subscriptions, are not supported in model settings yet, so you need an API key
  • No hosted or cloud version is documented. It runs on your own machine, and the npm launch path requires Node.js
  • Data is stored locally by default, but DeepSeek's data processing statement says it may report anonymized configuration information and project lists. Reporting can be turned off
  • Customizing beyond the settings pages means learning Cordis plugin concepts and editing YAML profile patches

Use cases

  • Running a local coding agent on a repository with DeepSeek models and reviewing its file changes as side-by-side diffs
  • Pointing the harness at a company gateway or self-hosted model server through a custom OpenAI- or Anthropic-compatible endpoint
  • Writing a plugin that adds a tool, model adapter, or sandbox without forking the harness
  • Driving the agent from a Python program through the SDK, with a disposable workspace for each task
  • Starting an automatic read-only review session when a GitHub pull request moves from draft to ready for review

Our take

DeepSeek Harness is most interesting as a runtime you can take apart. Because models, tools, sandboxes, and the UI are all plugins, and every context injection is logged, it suits developers who want to see and change how an agent works. Multi-provider support and a Python SDK widen its use beyond DeepSeek models. For day-to-day coding, its maturity is the constraint: only pre-release versions exist, breaking changes are expected, DeepSeek itself says it is not security audited, and the newest capabilities are experimental. Run it in an isolated environment and treat it as a preview.

Who should use it

Developers who want an open-source agent harness from DeepSeek to experiment with, plugin authors, researchers running agent benchmarks through the SDK, and teams that want to point a local agent at their own model gateway.

Who should skip it

Teams that need a stable coding agent for production code today, organizations that require a security-reviewed tool, and users who want to sign in with an existing subscription instead of an API key.

Strengths

  • Open source under MIT, from the lab that trains the DeepSeek models
  • Every part of the agent is a plugin, so tools, models, and sandboxes can be swapped through configuration
  • Works with other providers and any OpenAI- or Anthropic-compatible endpoint, not only DeepSeek
  • Append-only session logs make the agent's context and tool calls inspectable
  • Several entry points: web UI, headless runs, ACP for editors, and a Python SDK

Weaknesses

  • Developer preview with compatibility-breaking changes and only pre-release versions
  • Not security audited; DeepSeek recommends running it in a disposable VM or container
  • Browser Use, Computer Use, and Auto review are experimental
  • No OAuth sign-in for subscription providers such as Codex yet
  • Deeper customization requires learning the Cordis plugin model

DeepSeek Harness pricing

Open Source

Free

  • MIT-licensed harness, web UI, and SDK
  • Runs on your own machine

Note: DeepSeek does not charge for the harness. Model calls are billed by the provider whose API key you add, such as the DeepSeek API or a third-party or self-hosted endpoint.

Technical specs

API pricing

The harness, SDK, and ACP and headless profiles are free; model usage is billed by the provider whose API key you configure

Available models

DeepSeek models via the DeepSeek API (default)Anthropic, OpenAI, Moonshot AI (Kimi), and Z.ai (GLM) via the built-in provider catalogCustom endpoints speaking OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages

Where DeepSeek Harness excels

Trying DeepSeek models on a real repository

One npx command starts a local web UI with DeepSeek as the default provider, and file changes appear as side-by-side diffs you can review.

Running an agent against an internal model gateway

A custom provider accepts any base URL that speaks OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages, with request-compatibility switches for gateways that differ from OpenAI.

Building a custom agent preset without forking

Tools, model adapters, sandboxes, and loops are Cordis plugins, so a profile can add or replace pieces through configuration, and the minimal and creation modes give smaller starting points.

DeepSeek Harness vs. competitors

DeepSeek Harness vs. OpenCode

OpenCode is an open-source coding agent built for many model providers and focused on the terminal. DeepSeek Harness is also open source and multi-provider, but it defaults to DeepSeek, runs as a local web UI, and makes every part of the agent a plugin.

DeepSeek Harness vs. Claude Code

Claude Code is Anthropic's commercial coding agent for Claude models across the terminal, IDEs, desktop, and web. DeepSeek Harness is an MIT-licensed preview built around DeepSeek models that you run and extend yourself.

DeepSeek Harness vs. OpenAI Codex

OpenAI Codex pairs an open-source CLI with parallel cloud tasks tied to ChatGPT plans. DeepSeek Harness has no hosted cloud; it runs locally, and model usage is billed through the provider API key you configure.

DeepSeek Harness vs. Pi Coding Agent

Pi is a deliberately minimal terminal agent extended through TypeScript packages. DeepSeek Harness also leans on plugins but ships more built in, including a web UI, MCP, subagents, approvals, and scheduling. Its adapter for third-party providers and custom endpoints is built on Pi's pi-ai library.

Frequently asked questions

What is DeepSeek Harness?

DeepSeek Harness (`dsh`) is an open-source agent harness developed by DeepSeek AI. It runs locally as a web UI where an agent reads and edits files in a workspace, runs commands, delegates to subagents, and uses MCP tools. Everything in it, from models to sandboxes to the UI, is a plugin.

Is DeepSeek Harness free and open source?

Yes. The code is MIT licensed on GitHub. The harness itself is free; you pay the model provider whose API key you configure, such as the DeepSeek API.

Does DeepSeek Harness only work with DeepSeek models?

No. DeepSeek is the default, but the model settings include a catalog of third-party providers such as Anthropic, OpenAI, Moonshot AI (Kimi), and Z.ai (GLM), and you can add any endpoint that speaks OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages. OAuth-based providers such as Codex are not supported yet.

How do I install DeepSeek Harness?

Install Node.js and run `npx @deepseek-ai/dsh web`. That starts the web UI at http://127.0.0.1:3080. Then add a DeepSeek API key under Settings → Models and choose a workspace folder. You can also build it from source with pnpm, or install the Python SDK with `pip install deepseek-harness-sdk`.

Is there a DeepSeek Harness desktop app?

The repository contains an Electron desktop app for macOS and Windows, and recent release notes describe desktop features. However, DeepSeek's harness page and the GitHub releases don't offer an official download yet. The documented way to run it is `npx @deepseek-ai/dsh web`. Treat third-party sites offering 'DeepSeek Harness Desktop' installers with caution, because DeepSeek's own pages don't link to them.

Is DeepSeek Harness safe to use on real projects?

DeepSeek says the project is experimental developer-preview software that has not been security audited. It can run model-generated commands and load third-party plugins, and its sandboxing and approval prompts do not guarantee isolation. DeepSeek recommends least privilege, backups, and a disposable VM or container.

DeepSeek Harness vs Claude Code: what is the difference?

Claude Code is Anthropic's commercial coding agent for Claude models. DeepSeek Harness is an MIT-licensed, plugin-based harness that defaults to DeepSeek models, runs as a local web UI, and is still in developer preview.

Integrations & fit

DeepSeek APIAnthropicOpenAIMoonshot AI (Kimi)Z.ai (GLM)OpenAI-compatible endpointsMCPGitHub webhooksAgent Client Protocol (ACP)Python SDK
Good fit forSolo / individual, Startup / small team
Pricing modelFree· No cost to start
See pricing on DeepSeek Harness →

Alternatives to consider

About DeepSeek Harness

DeepSeek Harness is DeepSeek's own agent harness, built on the Cordis plugin framework with an everything-is-a-plugin design: models, tools, skills, sessions, sandboxes, storage, agent loops, scheduling, and the UI are all plugins, composed through configuration rather than source changes. You start it with `npx @deepseek-ai/dsh web`, which serves a web UI on 127.0.0.1:3080. You then add a DeepSeek API key under Settings → Models, choose a workspace folder, and give the agent a task. It can read and edit files, run commands, delegate work, and keep a plan, and it asks before actions that the active permission policy marks for approval. DeepSeek is the default provider, but the built-in catalog also covers providers such as Anthropic, OpenAI, Moonshot AI (Kimi), and Z.ai (GLM), and you can add any gateway or self-hosted server that speaks OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages. Providers that sign in with OAuth, such as Codex, are not supported yet. DeepSeek describes four modes: Standard (the full coding agent), Code mode (called PTC in the Chinese docs), where the model combines multi-step tool calls in one TypeScript program, Minimal, with only persistent bash and a file editor, and Creator, for building custom agent presets. The same `dsh` command also runs one-shot headless jobs, serves editors over the Agent Client Protocol (ACP), and backs a Python SDK. Sessions are logged append-only, including system prompts, reasoning, tool calls, and every context injection, so you can trace why the agent did something. Pre-releases in September 2026 added experimental Browser Use and Computer Use, terminals in the web sidebar, an experimental Auto review mode, and scheduled reminders. The repository also contains an Electron desktop app, but DeepSeek's harness page and the GitHub releases do not offer an official download, so the npx web UI is the documented way to run it. The tradeoff is maturity. Every release so far is a 0.1.x alpha or release candidate, the README warns of compatibility-breaking changes, and DeepSeek's safety notice says the project has not been security audited and should run in a disposable VM or container. It fits developers who want to experiment with or extend an agent runtime more than teams looking for a stable daily coding tool.

Updates from DeepSeek Harness

New Featurev0.1.7-rc.2 adds scheduled tasks and background desktop runs

The pre-release adds reminders with run history that survive restarts, desktop onboarding, customizable keyboard shortcuts, and tasks that keep running in the background after the desktop window closes. Scheduled tasks and time context are off by default.

New Featurev0.1.7-rc.1 adds web terminals, Auto review, and browser and computer use

The pre-release adds terminals in the web sidebar, session archiving, MCP resource discovery, headless stdin task input, a plugin management UI, experimental Computer Use and Browser Use, and an experimental Auto review mode.

Are you the founder? Claim this listing →