A mirror of the official deepseek harness repo https://deepseek.com/harness
  • TypeScript 95.3%
  • CSS 1.3%
  • Python 1.1%
  • JavaScript 0.8%
  • Swift 0.6%
  • Other 0.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-13 15:37:50 +08:00
.agents Merge branch 'master' into sync branch 2026-11-13 13:44:32 +08:00
.claude docs: accuracy sweep, architecture restructure, two ADRs, review skill 2026-06-13 22:05:34 +08:00
.github Merge remote-tracking branch 'origin/master' into fix/rollout-website-approval 2026-11-13 14:50:54 +08:00
apps Merge branch 'master' into worktree-sync-release-dsh-0.2.2-rc.3-to-master 2026-11-13 15:26:46 +08:00
benchmarks refactor(exports): retire obsolete subpaths with compatible brand APIs (#8215) 2026-11-11 08:39:14 +00:00
docs Merge pull request #7940 from deepseek-harness/refactor/cordis-include-yaml 2026-11-13 15:26:20 +08:00
native chore(deps): update source and build tools 2026-10-07 18:08:01 +08:00
packages Merge pull request #8422 from deepseek-harness/worktree-sync-release-dsh-0.2.2-rc.3-to-master 2026-11-13 15:37:50 +08:00
patches Merge master into subagent runtime stack base 2026-10-29 17:55:40 +08:00
python refactor(jobs,terminal): import HarnessError from dsh-error 2026-11-05 21:40:22 +08:00
scripts Merge pull request #7940 from deepseek-harness/refactor/cordis-include-yaml 2026-11-13 15:26:20 +08:00
snapshots Merge branch 'release/dsh-0.2.2' into master 2026-11-13 13:26:31 +08:00
vendor Merge pull request #7940 from deepseek-harness/refactor/cordis-include-yaml 2026-11-13 15:26:20 +08:00
website refactor(agent-preset): consolidate creator skills into dsh-doc (#6633) 2026-11-05 17:53:22 +08:00
.editorconfig Declare LF and final-newline conventions in .editorconfig 2026-07-15 16:09:12 +08:00
.gitattributes feat(forge-panel): let repositories declare review layers in .gitattributes 2026-11-06 18:47:22 +08:00
.gitignore feat(release): publish package source, declaration maps, and documentation (#5884) 2026-11-05 00:22:36 +08:00
.gitlab-ci.yml feat(python): support macOS x64 runtime wheels 2026-09-03 11:16:34 +08:00
.jscpd.json chore(lint): bring .tsx files into the eslint, lefthook, and jscpd lanes 2026-07-27 21:42:08 +08:00
.oxlintrc.json fix(experimental): close the mods bridge review findings 2026-10-03 05:18:32 +08:00
.oxlintrc.staged.json refactor: make lint workflows Oxlint-only 2026-08-09 14:55:15 +08:00
.rgignore chore: exclude archived Agent Notes from rg 2026-08-10 14:49:30 +08:00
AGENTS.md feat(infra): reject silent empty catch clauses 2026-11-11 12:47:00 +08:00
BENCHMARK.md docs: make Web UI the primary onboarding path 2026-08-12 11:44:33 +08:00
BRAND_GUIDELINES.i18n.yaml feat(i18n): key translation pairing records by heading section (#5036) 2026-09-23 22:32:06 +08:00
BRAND_GUIDELINES.md docs: split brand guidelines into bilingual pair 2026-08-19 21:01:18 +08:00
BRAND_GUIDELINES.zh.md docs: split brand guidelines into bilingual pair 2026-08-19 21:01:18 +08:00
CLAUDE.md Initialize repo with README, AGENTS.md, and CLAUDE.md symlink 2026-06-10 22:58:56 +08:00
CONTRIBUTING.i18n.yaml feat(i18n): key translation pairing records by heading section (#5036) 2026-09-23 22:32:06 +08:00
CONTRIBUTING.md docs(i18n): refine contribution guide wording 2026-08-12 14:24:44 +08:00
CONTRIBUTING.zh.md docs(i18n): polish contribution greeting 2026-08-12 14:40:32 +08:00
lefthook.yml fix(llm): 生成提供方元数据并显示凭据检测状态 (#6106) 2026-10-14 12:29:31 +08:00
LICENSE Adopt MIT for DSH packages 2026-08-13 13:07:24 +08:00
Makefile chore(build): limit PR to the make clean shortcut 2026-10-09 14:01:12 +08:00
package.json Merge branch 'release/dsh-0.2.2' into master 2026-11-13 15:12:47 +08:00
pnpm-lock.yaml Merge pull request #7940 from deepseek-harness/refactor/cordis-include-yaml 2026-11-13 15:26:20 +08:00
pnpm-workspace.yaml chore(deps): unify zod to 4.6.6 2026-11-05 11:27:26 +08:00
pytest.ini Merge remote-tracking branch 'origin/master' into codex/trim-ai-prose 2026-07-14 00:40:36 +08:00
README.i18n.yaml docs: simplify Chinese README community signup (#5311) 2026-09-29 04:57:46 +00:00
README.md docs: fix expired Discord invite (#5433) (#5437) 2026-09-29 12:42:50 +08:00
README.zh.md docs: simplify Chinese README community signup (#5311) 2026-09-29 04:57:46 +00:00
SAFETY.i18n.yaml feat(i18n): key translation pairing records by heading section (#5036) 2026-09-23 22:32:06 +08:00
SAFETY.md Merge pull request #2560 from deepseek-harness/codex/add-security-policy 2026-08-23 11:10:52 +08:00
SAFETY.zh.md Merge pull request #2560 from deepseek-harness/codex/add-security-policy 2026-08-23 11:10:52 +08:00
THIRD_PARTY_NOTICES.md refactor(client): converge search lists on shared multilingual fuzzy filter 2026-11-13 13:05:16 +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 branch 'master' into sync branch 2026-11-13 14:18:42 +08:00
tsconfig.client.json Merge branch 'release/dsh-0.2.2' into master 2026-11-13 13:26:31 +08:00
tsconfig.host.json Merge branch 'master' into sync branch 2026-11-13 14:18:42 +08:00
tsconfig.json refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
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 branch 'release/dsh-0.2.2' into master 2026-11-13 13:26:31 +08:00
vitest.e2e.config.ts refactor: remove runtime invariant plugins 2026-09-30 12:52:18 +08:00
vitest.expected.config.ts refactor: remove runtime invariant plugins 2026-09-30 12:52:18 +08:00
vitest.shared.ts fix(typert): close remote gateway review gaps 2026-08-07 21:47:15 +08:00
vitest.snapshot.config.ts refactor: remove runtime invariant plugins 2026-09-30 12:52:18 +08:00
vitest.web-stress.config.ts test(web): run fixture browser cases through Host 2026-09-13 21:30:02 +08:00
vitest.web.config.ts feat(inspector): define shared protocol foundation 2026-08-27 16:15:17 +08:00
vitest.web.perf.config.ts fix(history): adapt packed pages to session journal 2026-08-25 20:10:43 +08:00

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.