DeepSeek · DeepSeek Harness: Open-Source, Plugin-Based Agent Harness from DeepSeek
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.
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
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.
Open Source
Free
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.
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
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. 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.
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.

Anomaly
Developers who want a terminal-based AI coding agent with no vendor lock-in, the ability to bring any LLM provider, and undo control over agent file changes
FreeAnthropic
Developers and teams who want deep codebase reasoning, multi-file changes, and persistent project instructions in a terminal-friendly or IDE-native workflow
Paid
OpenAI
Developers and teams already paying for ChatGPT Plus, Pro, Business, or Enterprise who want one coding agent across the terminal, IDE, and parallel cloud tasks
FreemiumEarendil Inc.
Developers who want a small, model-agnostic terminal agent they fully control and are willing to extend with their own tools, and teams embedding an agent loop in their own software
FreeDeepSeek 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.
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.
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 →