DeepSeek Harness: Everything is a Plugin.
  • TypeScript 95.4%
  • CSS 1.4%
  • Python 1.3%
  • JavaScript 0.8%
  • Swift 0.5%
  • Other 0.4%
Find a file
2026-11-04 16:40:00 +08:00
.agents Merge master into desktop channel version policy 2026-11-04 15:30:38 +08:00
.claude
.github Merge master into desktop channel version policy 2026-11-04 15:30:38 +08:00
apps Merge pull request #7873 from deepseek-harness/merge/release-dsh-0.2.2-rc.1-to-master 2026-11-04 16:40:00 +08:00
benchmarks Merge pull request #6978 from deepseek-harness/xtr/ptc-runner-imports 2026-11-02 17:24:05 +08:00
docs Merge pull request #7856 from deepseek-harness/docs/liveshare-surface-accuracy 2026-11-04 08:39:36 +00:00
native chore(deps): update source and build tools 2026-10-07 18:08:01 +08:00
packages Merge pull request #7873 from deepseek-harness/merge/release-dsh-0.2.2-rc.1-to-master 2026-11-04 16:40:00 +08:00
patches Merge master into subagent runtime stack base 2026-10-29 17:55:40 +08:00
python feat(web): 网页搜索与获取设置页分开选择 Search 与 Fetch,Search 默认改为 DeepSeek Search API 2026-11-03 13:04:26 +08:00
scripts Merge master into desktop channel version policy 2026-11-04 15:30:38 +08:00
snapshots Merge master into feat/subagent-catalog-names 2026-11-04 14:16:00 +08:00
vendor release(vendor): cordis 4.1.0, cosmokit 1.9.0, group 1.1.0, hmr 1.1.0, include 1.1.0, loader 1.1.0, logger-console 1.1.0, schemastery 3.19.0, timer 1.2.0 2026-11-04 15:48:54 +08:00
website Merge remote-tracking branch 'origin/master' into docs/long-table-filter 2026-10-23 16:05:14 +08:00
.editorconfig
.gitattributes Merge master and reconcile desktop diagnostic records 2026-10-26 11:05:45 +08:00
.gitignore docs: define UI design decisions and review workflow 2026-11-03 20:38:25 +08:00
.gitlab-ci.yml
.jscpd.json
.oxlintrc.json fix(experimental): close the mods bridge review findings 2026-10-03 05:18:32 +08:00
.oxlintrc.staged.json
.rgignore
AGENTS.md docs: expose UI design references through one skill 2026-11-03 20:39:03 +08:00
BENCHMARK.md
BRAND_GUIDELINES.i18n.yaml
BRAND_GUIDELINES.md
BRAND_GUIDELINES.zh.md
CLAUDE.md
CONTRIBUTING.i18n.yaml
CONTRIBUTING.md
CONTRIBUTING.zh.md
lefthook.yml fix(llm): 生成提供方元数据并显示凭据检测状态 (#6106) 2026-10-14 12:29:31 +08:00
LICENSE
Makefile chore(build): limit PR to the make clean shortcut 2026-10-09 14:01:12 +08:00
package.json release(dsh): 0.2.2-rc.1 2026-11-04 15:50:06 +08:00
pnpm-lock.yaml Merge pull request #7569 from deepseek-harness/ux/session-menu-open-in-app 2026-11-04 15:26:58 +08:00
pnpm-workspace.yaml fix(ui-primitives): end bare URLs before CJK punctuation 2026-10-26 18:43:12 +08:00
pytest.ini
README.i18n.yaml
README.md
README.zh.md
SAFETY.i18n.yaml
SAFETY.md
SAFETY.zh.md
THIRD_PARTY_NOTICES.md Merge pull request #7552 from deepseek-harness/fix/webworker-live-import-bindings 2026-10-30 00:13:15 +08:00
tsconfig.base.client.json feat(client): serve plugin package assets by URL instead of data URLs 2026-10-20 02:13:37 +08:00
tsconfig.base.json Merge remote-tracking branch 'origin/master' into feat/mcp-manager-core 2026-11-03 13:37:58 +08:00
tsconfig.client.json test: classify shared continuation fixture as client 2026-11-04 12:49:31 +08:00
tsconfig.host.json Merge master into ux/session-menu-open-in-app 2026-11-04 12:31:38 +08:00
tsconfig.json
tsconfig.node.base.json Build shared Client bundles independently for Node and browser 2026-10-14 14:43:59 +08:00
tsdown.config.ts Generate source metadata before package compilation 2026-10-18 14:29:23 +08:00
vitest.bench.config.ts revert: remove follow-up CI repairs 2026-10-31 10:40:31 +08:00
vitest.config.ts Merge master into worktree-sync-dsh-0.2.2-to-master 2026-11-03 11:47:40 +08:00
vitest.e2e.config.ts
vitest.expected.config.ts
vitest.shared.ts
vitest.snapshot.config.ts
vitest.web-stress.config.ts
vitest.web.config.ts
vitest.web.perf.config.ts

DeepSeek Harness

English | 中文

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

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

Documentation: https://deepseek-harness.github.io/deepseek-harness/

Developer preview

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

Review the safety notice before running the project.

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

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

pnpm run dev:web builds, serves, and rebuilds client bundles on source edits in one terminal, and make help lists the matching Make targets for Web and Desktop; the guide's application commands section owns the full table.

For agents, follow AGENTS.md.

Citation

@misc{deepseek-harness2026,
  title={DeepSeek Harness: Everything is a Plugin},
  author={DeepSeek-AI},
  year={2026},
  publisher={GitHub},
  howpublished={\url{https://github.com/deepseek-ai/deepseek-harness}},
}

License

MIT

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