Watch
1
1
Fork
You've already forked deepseek-harness
0
mirror of https://github.com/deepseek-ai/deepseek-harness.git synced 2026-09-16 11:10:54 +00:00
DeepSeek Harness: Everything is a Plugin. https://deepseek.com/harness
  • TypeScript 96.8%
  • CSS 1.3%
  • Python 1.1%
  • JavaScript 0.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-15 11:16:06 +08:00
.agents perf(typert): materialize generated schemas on first use 2026-09-15 11:06:43 +08:00
.claude docs: accuracy sweep, architecture restructure, two ADRs, review skill 2026-06-13 22:05:34 +08:00
.github test(ci): exercise Messages defaults in runtime smokes 2026-09-13 20:36:50 +08:00
apps perf(web): defer client combo assembly 2026-09-15 11:00:34 +08:00
benchmarks perf(runtime): defer optional native dependencies 2026-09-15 11:06:43 +08:00
docs perf(typert): materialize generated schemas on first use 2026-09-15 11:06:43 +08:00
native Fix offline reference checks and preserve native pack inputs 2026-09-12 18:37:56 +08:00
packages perf(typert): materialize generated schemas on first use 2026-09-15 11:06:43 +08:00
patches fix(pkg): restore VFS Dirent reads 2026-09-14 23:10:47 +08:00
python feat(boot): add profile resolution modes 2026-09-14 22:30:48 +08:00
scripts feat(util): add caller-relative lazy require 2026-09-15 11:06:42 +08:00
snapshots fix(web): hold a compaction summary's code banner below the pinned header 2026-09-15 00:03:33 +08:00
vendor chore(runtime): upgrade builtin loader to 0.1.6 2026-09-14 22:52:44 +08:00
website fix(docs): align Mermaid viewer accessible titles 2026-09-14 14:49:48 +08:00
.editorconfig Declare LF and final-newline conventions in .editorconfig 2026-07-15 16:09:12 +08:00
.gitattributes docs(session): nest historical formats under persistence changes 2026-09-13 12:19:46 +08:00
.gitignore feat(native): add prebuilt Node-API flock support 2026-09-08 20:49:10 +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 chore(session): scope history reader exemptions to tests 2026-09-09 12:55: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 fix(browser-use): integrate current MCP resources and snapshots 2026-09-13 22:39:17 +08:00
BENCHMARK.md docs: make Web UI the primary onboarding path 2026-08-12 11:44:33 +08:00
BRAND_GUIDELINES.i18n.yaml docs: split brand guidelines into bilingual pair 2026-08-19 21:01:18 +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 docs(i18n): polish contribution greeting 2026-08-12 14:40:32 +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(client): keep browser dependencies out of production installs 2026-09-09 00:30:37 +08:00
LICENSE Adopt MIT for DSH packages 2026-08-13 13:07:24 +08:00
package.json release(dsh): 0.1.6-alpha.1 2026-09-15 09:35:57 +08:00
pnpm-lock.yaml perf(runtime): defer optional native dependencies 2026-09-15 11:06:43 +08:00
pnpm-workspace.yaml chore(runtime): upgrade builtin loader to 0.1.6 2026-09-14 22:52:44 +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: add BibTeX citation to READMEs 2026-09-10 11:49:17 +08:00
README.md docs: add BibTeX citation to READMEs 2026-09-10 11:49:17 +08:00
README.zh.md docs: add BibTeX citation to READMEs 2026-09-10 11:49:17 +08:00
SAFETY.i18n.yaml Merge pull request #2560 from deepseek-harness/codex/add-security-policy 2026-08-23 11:10:52 +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 Merge pull request #4137 from deepseek-harness/feat/docs-site-mermaid-viewer 2026-09-14 17:57:00 +08:00
tsconfig.base.client.json feat(client): inject public build environment 2026-08-19 18:21:26 +08:00
tsconfig.base.json feat(util): add caller-relative lazy require 2026-09-15 11:06:42 +08:00
tsconfig.client.json Merge remote-tracking branch 'origin/master' into worktree/web-sidebar-terminal 2026-09-14 10:36:31 +08:00
tsconfig.host.json feat(util): add caller-relative lazy require 2026-09-15 11:06:42 +08:00
tsconfig.json refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
tsdown.config.ts fix(desktop): move host out of CLI package 2026-09-04 16:21:45 +08:00
vitest.bench.config.ts test(perf): gate long-session browser and active reconnect workflows 2026-09-07 13:29:38 +08:00
vitest.config.ts feat(docs): add fullscreen Mermaid diagram viewer 2026-09-14 12:25:23 +08:00
vitest.e2e.config.ts test: start every suite from an environment with no proxy 2026-08-29 13:17:12 +08:00
vitest.expected.config.ts test: start every suite from an environment with no proxy 2026-08-29 13:17:12 +08:00
vitest.shared.ts fix(typert): close remote gateway review gaps 2026-08-07 21:47:15 +08:00
vitest.snapshot.config.ts test: start every suite from an environment with no proxy 2026-08-29 13:17:12 +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.

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.