2nd dokployH

Find a file

Turtle 93a1b569ac Merge remote-tracking branch 'origin/master' into codex/remove-cordis-catalog-line-numbers # Conflicts: # docs/subsystems/agent-team.i18n.yaml # docs/subsystems/approval.i18n.yaml # docs/subsystems/client-modules.i18n.yaml # docs/subsystems/client-modules.md # docs/subsystems/client-modules.zh.md # docs/subsystems/code-runtime.i18n.yaml # docs/subsystems/commands.i18n.yaml # docs/subsystems/commands.md # docs/subsystems/commands.zh.md # docs/subsystems/compaction.i18n.yaml # docs/subsystems/compaction.md # docs/subsystems/compaction.zh.md # docs/subsystems/core.i18n.yaml # docs/subsystems/core.md # docs/subsystems/core.zh.md # docs/subsystems/credentials.i18n.yaml # docs/subsystems/credentials.md # docs/subsystems/credentials.zh.md # docs/subsystems/feedback.i18n.yaml # docs/subsystems/filesystem.i18n.yaml # docs/subsystems/goal.i18n.yaml # docs/subsystems/http-server.md # docs/subsystems/http-server.zh.md # docs/subsystems/invariants.i18n.yaml # docs/subsystems/invariants.md # docs/subsystems/invariants.zh.md # docs/subsystems/jobs.i18n.yaml # docs/subsystems/llm-streaming.i18n.yaml # docs/subsystems/llm-streaming.md # docs/subsystems/llm-streaming.zh.md # docs/subsystems/permission-presets.md # docs/subsystems/permission-presets.zh.md # docs/subsystems/persistence.i18n.yaml # docs/subsystems/persistence.md # docs/subsystems/persistence.zh.md # docs/subsystems/plan.i18n.yaml # docs/subsystems/plan.md # docs/subsystems/plan.zh.md # docs/subsystems/sandbox.i18n.yaml # docs/subsystems/sandbox.md # docs/subsystems/sandbox.zh.md # docs/subsystems/schedule.i18n.yaml # docs/subsystems/session-projection.i18n.yaml # docs/subsystems/session-projection.md # docs/subsystems/session-projection.zh.md # docs/subsystems/session-query.i18n.yaml # docs/subsystems/session-reference.i18n.yaml # docs/subsystems/session-reference.md # docs/subsystems/session-reference.zh.md # docs/subsystems/session-telemetry.md # docs/subsystems/session-telemetry.zh.md # docs/subsystems/session-title.i18n.yaml # docs/subsystems/session.i18n.yaml # docs/subsystems/session.md # docs/subsystems/session.zh.md # docs/subsystems/settings.i18n.yaml # docs/subsystems/settings.md # docs/subsystems/settings.zh.md # docs/subsystems/shell.i18n.yaml # docs/subsystems/shell.md # docs/subsystems/shell.zh.md # docs/subsystems/skills.i18n.yaml # docs/subsystems/skills.md # docs/subsystems/skills.zh.md # docs/subsystems/spill.i18n.yaml # docs/subsystems/storage.i18n.yaml # docs/subsystems/subagent.i18n.yaml # docs/subsystems/subagent.md # docs/subsystems/subagent.zh.md # docs/subsystems/subprocess.i18n.yaml # docs/subsystems/system-prompt.i18n.yaml # docs/subsystems/system-prompt.md # docs/subsystems/system-prompt.zh.md # docs/subsystems/tasks.md # docs/subsystems/tasks.zh.md # docs/subsystems/terminal.md # docs/subsystems/terminal.zh.md # docs/subsystems/token-meter.i18n.yaml # docs/subsystems/tools.i18n.yaml # docs/subsystems/tools.md # docs/subsystems/tools.zh.md # docs/subsystems/typert.i18n.yaml # docs/subsystems/typert.md # docs/subsystems/typert.zh.md # docs/subsystems/user-interaction.i18n.yaml # docs/subsystems/user-questions.i18n.yaml # docs/subsystems/user-questions.md # docs/subsystems/user-questions.zh.md # docs/subsystems/web.i18n.yaml # docs/subsystems/workflow.i18n.yaml # docs/subsystems/workflow.md # docs/subsystems/workflow.zh.md # docs/subsystems/workspace.i18n.yaml # docs/subsystems/workspace.md # docs/subsystems/workspace.zh.md # packages/typert/generator/tests/cordis-catalog.spec.ts		2026-08-20 19:48:43 +08:00
.agents	Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links	2026-08-20 19:15:33 +08:00
.claude	docs: accuracy sweep, architecture restructure, two ADRs, review skill	2026-06-13 22:05:34 +08:00
.github	fix(cic): address gray-check PR review - official build, step-level gate, note sync	2026-08-20 15:21:59 +08:00
apps	Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links	2026-08-20 19:15:33 +08:00
docs	Merge remote-tracking branch 'origin/master' into codex/remove-cordis-catalog-line-numbers	2026-08-20 19:48:43 +08:00
examples	Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links	2026-08-20 19:15:33 +08:00
native	docs(i18n): localize Chinese internal links	2026-08-18 19:00:37 +08:00
packages	Merge remote-tracking branch 'origin/master' into codex/remove-cordis-catalog-line-numbers	2026-08-20 19:48:43 +08:00
patches	chore(subprocess-local): bump node-pty beta	2026-08-13 17:58:13 +08:00
python	Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links	2026-08-20 19:15:33 +08:00
scripts	Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links	2026-08-20 19:15:33 +08:00
vendor	release(vendor): cordis 4.0.1, cosmokit 1.8.2, group 1.0.1, hmr 1.0.16, include 1.0.6, loader 1.0.2, logger-console 1.0.1, schemastery 3.18.1, timer 1.1.3	2026-08-13 14:18:56 +08:00
website	Merge remote-tracking branch 'origin/master' into feat/plugin-owned-settings-surface	2026-08-14 15:46:01 +08:00
.editorconfig	Declare LF and final-newline conventions in .editorconfig	2026-07-15 16:09:12 +08:00
.gitattributes	feat(i18n): compose pairing records during merges	2026-08-08 21:11:59 +08:00
.gitignore	feat(build): bind client artifacts to build profiles	2026-08-19 18:21:27 +08:00
.gitlab-ci.yml	Support MCP in packaged Python runtime	2026-08-18 13:50:53 +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	refactor: make lint workflows Oxlint-only	2026-08-09 14:55:15 +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(authorization): obtain a credential by asking the human	2026-08-20 17:58:38 +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
knip.json	Merge pull request #2758 from deepseek-harness/knip-eval	2026-08-20 10:59:36 +08:00
lefthook.yml	Revert "fix(client): declare browser-only externals as devDependencies"	2026-08-15 02:19:09 +08:00
LICENSE	Adopt MIT for DSH packages	2026-08-13 13:07:24 +08:00
package.json	release(dsh): 0.1.0-rc.8	2026-08-19 23:00:28 +08:00
pnpm-lock.yaml	feat(llm-pi-ai): sign in to a provider instead of withholding it	2026-08-20 17:58:38 +08:00
pnpm-workspace.yaml	chore(subprocess-local): bump node-pty beta	2026-08-13 17:58:13 +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	Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links	2026-08-20 19:15:33 +08:00
README.md	feat(web,cli): open the ready Web UI by default	2026-08-19 15:42:12 +08:00
README.zh.md	Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links	2026-08-20 19:15:33 +08:00
THIRD_PARTY_NOTICES.md	feat(web,cli): open the ready Web UI by default	2026-08-19 15:42:12 +08:00
tsconfig.base.client.json	feat(client): inject public build environment	2026-08-19 18:21:26 +08:00
tsconfig.base.json	feat(authorization): obtain a credential by asking the human	2026-08-20 17:58:38 +08:00
tsconfig.client.json	feat(client): compose deployment branding through slots	2026-08-19 18:21:35 +08:00
tsconfig.host.json	feat(authorization): obtain a credential by asking the human	2026-08-20 17:58:38 +08:00
tsconfig.json	refactor(tsconfig): single root solution graph over host/client aggregates	2026-07-23 03:59:05 +08:00
tsdown.config.ts	refactor: apply repository naming contract	2026-08-13 00:54:38 +08:00
vitest.config.ts	Merge remote-tracking branch 'origin/master' into dshw/pr-deepseek-harness-deepseek-harness-2300	2026-08-19 10:33:31 +08:00
vitest.e2e.config.ts	fix(typert): close remote gateway review gaps	2026-08-07 21:47:15 +08:00
vitest.shared.ts	fix(typert): close remote gateway review gaps	2026-08-07 21:47:15 +08:00
vitest.snapshot.config.ts	chore: remove remaining SDK toolchain residue	2026-08-11 16:37:29 +08:00
vitest.web-stress.config.ts	test(web): add opt-in reasoning chunk stress lane	2026-08-04 14:37:31 +08:00
vitest.web.config.ts	perf(ci): parallelize coverage and web snapshots in-job	2026-08-18 21:15:20 +08:00
vitest.web.perf.config.ts	test: add opt-in web performance scenario	2026-08-04 14:23:34 +08:00

README.md

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.

Developer preview

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

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

Feel free to 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.