Explore / deepseek-harness

deepseek-ai

deepseek-harness

DeepSeek's open agent harness (`dsh`): everything is a plugin, on the Cordis composability runtime, with a local web UI one npx away. Developer preview, MIT, moving fast.

187,902 20,909 TypeScript MITupdated 3 days ago

agents orchestration

View on GitHubDispute this mapping →

Curator's take

Worth watching because of who ships it and how it's built: a frontier lab's own harness, structured so that every capability — models, tools, memory, UI — is a Cordis plugin rather than a hardcoded loop, which is why a `dsh-plugin` ecosystem appeared around it almost immediately. `npx @deepseek-ai/dsh web` gets you a working UI on port 3080 with nothing to configure. Do not build on it yet without accepting the terms the README states outright: developer preview, iterating rapidly, compatibility-breaking changes expected. The star count reflects the lab's gravity more than the maturity of the code, and the docs are thin next to harnesses that have been in production a year.

Mapped by ShipWithAI editors · links verified

README.md

DeepSeek Harness

English | 中文

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.

It uses an architecture where everything is a plugin, and is powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

Developer preview

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Run

Run from `npm`

Install Node.js, then run:

npx @deepseek-ai/dsh web

The command starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch. An SSH launch only prints the host URL because the SSH client or editor owns the local forwarded address. Pass --no-open to run the server without opening a browser. See Web UI guide.

Run from source

To run from a repository checkout:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build prepares the repository artifacts. pnpm dsh web uses those built artifacts without rebuilding.

Community and support

Feel free to submit feedback or bug reports through GitHub Discussions.
Add the dsh-plugin topic to your plugin repository for discoverability.
Join DeepSeek Harness Discord community.

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

For agents, follow AGENTS.md.

License

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.

Continue your stack

What teams reach for next — and why each earns a place beside deepseek-harness. Ranked by curator confidence.

Pairs well with

OpenViking

Volcengine's context database: memories, resources and skills as one `viking://` filesystem agents ls, tree and grep — L0/L1/L2 tiers, traceable retrieval, sessions distilled into memory.

Why it fitsOpenViking self-declares a dsh plugin, so its `viking://` context database drops in as the harness's memory and retrieval layer instead of you wiring a store into the agent loop yourself.

EverOS

One portable memory layer for every agent: conversations, files and trajectories kept as canonical Markdown, indexed locally by SQLite and LanceDB, with offline reflection that refines them.

Why it fitsEverOS ships dsh integration among its plugin targets, giving the harness a Markdown-native, local-first memory layer with reflection — the piece a plugin-everything harness deliberately leaves empty.

omnigent

Open-source meta-harness over Claude Code, Codex, Cursor, OpenCode, Hermes, Pi and custom agents: swap harnesses without rewriting, enforce policies and sandboxes, follow sessions from any device.

Why it fitsOmnigent exists to sit above harnesses and let you swap them without rewriting; dsh is exactly the kind of fast-moving, breaking-changes harness you'd want behind that abstraction rather than wired directly into your stack.

Alternative to See all + compare →

trueforge

TrueFoundry's open agent harness: the runtime loop — model calls, MCP tools, SKILL.md packs, sandboxing, approvals, compaction — behind a chat UI, HTTP API, TypeScript SDK and embeddable UI.

Why it fitsTwo open agent harnesses with a UI, an API and a plugin story. TrueForge is the more finished product — catalogs, sandboxing, approvals, compaction, Helm charts; dsh is a plugin substrate on Cordis in developer preview. Ship on TrueForge, watch dsh.