2nd dokployH

Find a file

Turtle d68ff7e66f Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants # Conflicts: # docs/module-graph.i18n.yaml # docs/module-graph.md # docs/module-graph.zh.md # packages/session/session-projection/src/invariant.ts # tsconfig.base.json		2026-09-01 11:18:11 +08:00
.agents	Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants	2026-09-01 11:18:11 +08:00
.claude
.github	Merge branch 'master' into turtle/pr-open-start-date	2026-08-31 16:27:41 +08:00
apps	Merge pull request #2907 from deepseek-harness/xtr/session-log-read-api	2026-09-01 10:49:54 +08:00
docs	Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants	2026-09-01 11:18:11 +08:00
native
packages	Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants	2026-09-01 11:18:11 +08:00
patches
python	refactor(session)!: remove SQLite persistence backend	2026-08-31 13:23:07 +08:00
scripts	Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants	2026-09-01 11:18:11 +08:00
snapshots	refactor(bundle): remove the agent spine demo	2026-08-31 11:23:30 +08:00
vendor	release(vendor): cordis 4.0.2, cosmokit 1.8.3, group 1.0.2, hmr 1.0.17, include 1.0.7, loader 1.0.3, logger-console 1.0.2, schemastery 3.18.2, timer 1.1.4	2026-08-30 11:04:50 +08:00
website
.editorconfig
.gitattributes
.gitignore
.gitlab-ci.yml
.jscpd.json
.oxlintrc.json
.oxlintrc.staged.json
.rgignore
AGENTS.md	Merge master into codex/omit-unneeded-invariants	2026-08-31 14:38:55 +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
LICENSE
package.json	release(dsh): 0.1.2-alpha.3	2026-08-31 23:39:37 +08:00
pnpm-lock.yaml	Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants	2026-09-01 11:18:11 +08:00
pnpm-workspace.yaml
pytest.ini
README.i18n.yaml
README.md
README.zh.md
SAFETY.i18n.yaml
SAFETY.md
SAFETY.zh.md
THIRD_PARTY_NOTICES.md	Merge origin/master into codex/remove-knip	2026-08-28 12:07:36 +08:00
tsconfig.base.client.json
tsconfig.base.json	Merge remote-tracking branch 'origin/master' into turtle/omit-unneeded-invariants	2026-09-01 11:18:11 +08:00
tsconfig.client.json	Merge commit 'bc954280ae67e349291e51e5787c6987e767fa40' into schedule-web-catalog	2026-08-28 07:24:24 +08:00
tsconfig.host.json	feat(session-turn-outline): whole-log turn outline projection	2026-08-31 19:46:53 +08:00
tsconfig.json
tsdown.config.ts
vitest.config.ts	cleanup: omit unneeded invariant companions	2026-08-28 13:12:52 +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

README.md

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

Submit feedback or bug reports through GitHub Discussions.
Add the dsh-plugin topic to your plugin repository for discoverability.
Join DeepSeek Harness Discord community.

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.