DeepSeek Harness: Everything is a Plugin. https://deepseek.com/harness
  • TypeScript 96.2%
  • CSS 1.4%
  • Python 1%
  • JavaScript 0.9%
  • PowerShell 0.2%
  • Other 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-09 17:31:32 +08:00
.agents Merge pull request #5915 from deepseek-harness/turtle/exp-badge-align-42f8ebeac170 2026-10-09 16:50:08 +08:00
.claude docs: accuracy sweep, architecture restructure, two ADRs, review skill 2026-06-13 22:05:34 +08:00
.github Merge pull request #5898 from deepseek-harness/build/windows-ci 2026-10-09 14:06:31 +08:00
apps Merge pull request #5946 from deepseek-harness/release-0.2.1-alpha.2 2026-10-09 17:31:32 +08:00
benchmarks ci(bench): warn on a missing benchmark report and document the artifact 2026-10-08 11:55:08 +08:00
docs Merge master into fix/prune-python-runtime-tests 2026-10-09 16:37:22 +08:00
native chore(deps): update source and build tools 2026-10-07 18:08:01 +08:00
packages Merge pull request #5946 from deepseek-harness/release-0.2.1-alpha.2 2026-10-09 17:31:32 +08:00
patches build(windows): add manual installer CI and scope desktop runtime patches 2026-10-08 18:54:47 +08:00
python Merge master into fix/prune-python-runtime-tests 2026-10-09 16:37:22 +08:00
scripts Merge master into fix/prune-python-runtime-tests 2026-10-09 16:37:22 +08:00
snapshots Merge pull request #5915 from deepseek-harness/turtle/exp-badge-align-42f8ebeac170 2026-10-09 16:50:08 +08:00
vendor chore(deps): upgrade Electron to 44.7.0 and native loader to 0.1.9 2026-10-09 11:22:14 +08:00
website chore(deps): update website rendering libraries 2026-10-07 18:50:53 +08:00
.editorconfig Declare LF and final-newline conventions in .editorconfig 2026-07-15 16:09:12 +08:00
.gitattributes feat(i18n): key translation pairing records by heading section (#5036) 2026-09-23 22:32:06 +08:00
.gitignore test(bench): add scaled machine and memory-pressure report 2026-10-07 20:42:30 +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 chore(build): limit PR to the make clean shortcut 2026-10-09 14:01:12 +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 feat(skill): complete shared Office runtime builds for SDK carriers 2026-09-17 21:10:12 +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 pull request #5946 from deepseek-harness/release-0.2.1-alpha.2 2026-10-09 17:31:32 +08:00
pnpm-lock.yaml Merge master into fix/prune-python-runtime-tests 2026-10-09 16:37:22 +08:00
pnpm-workspace.yaml docs(deps): explain coupled Electron and addon release exemptions 2026-10-09 11:37:56 +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 Support native HTTPS Web listeners 2026-10-08 19:49:01 +08:00
tsconfig.base.client.json feat(client): add ownership lifecycle primitives 2026-09-17 05:27:15 +08:00
tsconfig.base.json Merge remote-tracking branch 'origin/master' into worktree/ssh-helper-binaries 2026-10-08 15:06:19 +08:00
tsconfig.client.json fix(experimental): retain published names and centralize identity policy 2026-10-06 16:42:25 +08:00
tsconfig.host.json Merge origin/master into fix/4931-composer-focus 2026-10-09 16:10:14 +08:00
tsconfig.json refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
tsdown.config.ts chore(build): limit PR to the make clean shortcut 2026-10-09 14:01:12 +08:00
vitest.bench.config.ts test(bench): add scaled machine and memory-pressure report 2026-10-07 20:42:30 +08:00
vitest.config.ts test(experimental): preserve platform and installed-profile coverage 2026-10-06 16:41:34 +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.