2nd dokployH
Find a file
2026-08-25 17:14:23 +08:00
.agents Merge remote-tracking branch 'origin/master' into worktree/2848-image-token-pressure 2026-08-25 17:03:42 +08:00
.claude
.github ci(windows): make windows-coverage temporarily non-blocking 2026-08-25 17:02:16 +08:00
apps test(web): authenticate folding snapshot page 2026-08-25 17:14:23 +08:00
docs Merge remote-tracking branch 'origin/master' into worktree/2848-image-token-pressure 2026-08-25 15:52:17 +08:00
native
packages test(subagent): exercise proxy EOF on Windows 2026-08-25 17:04:35 +08:00
patches
python refactor(python): keep launch override on client 2026-08-25 12:21:51 +08:00
scripts Merge remote-tracking branch 'origin/master' into worktree/2848-image-token-pressure 2026-08-25 17:03:42 +08:00
snapshots test(snapshot): refresh image request header 2026-08-25 15:59:44 +08:00
vendor
website refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
.editorconfig
.gitattributes
.gitignore feat(python-runtime): package the dsh CLI and profile assets 2026-08-24 17:28:26 +08:00
.gitlab-ci.yml fix(python): make Windows release paths native 2026-08-24 19:09:40 +08:00
.jscpd.json
.oxlintrc.json
.oxlintrc.staged.json
.rgignore
AGENTS.md refactor(repo): retire top-level examples 2026-08-24 22:02:44 +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
knip.json fix(test): declare Loader fixture dependencies 2026-08-24 22:02:44 +08:00
lefthook.yml
LICENSE
package.json refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
pnpm-lock.yaml Revert "Merge pull request #2698 from deepseek-harness/xtr/session-format-migration" 2026-08-25 15:30:10 +08:00
pnpm-workspace.yaml refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
pytest.ini
README.i18n.yaml Merge pull request #2560 from deepseek-harness/codex/add-security-policy 2026-08-23 11:10:52 +08:00
README.md Merge pull request #2560 from deepseek-harness/codex/add-security-policy 2026-08-23 11:10:52 +08:00
README.zh.md Merge pull request #2560 from deepseek-harness/codex/add-security-policy 2026-08-23 11:10:52 +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 refactor(webserver): minimize HTTP gzip integration 2026-08-25 06:43:24 +08:00
tsconfig.base.client.json
tsconfig.base.json Merge pull request #2663 from deepseek-harness/feat/subagent-provider 2026-08-24 18:23:42 +08:00
tsconfig.client.json chore(client): align split package graph 2026-08-23 16:28:18 +08:00
tsconfig.host.json fix(ui-workspace): keep blank new sessions outside the fold quota 2026-08-25 14:36:56 +08:00
tsconfig.json refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
tsdown.config.ts
vitest.config.ts refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
vitest.e2e.config.ts refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
vitest.expected.config.ts refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
vitest.shared.ts
vitest.snapshot.config.ts fix(test): use expected-output naming 2026-08-24 21:37:14 +08:00
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 uses an architecture where everything is a plugin, and is 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 currently in developer preview and is 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.

License

MIT

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