Local activation results were derived only from committed Session events. When the first turn/end append failed, no ending existed and the result defaulted to completed. When the first turn/start append failed, the initial message remained unclaimed and kept the idle activation resident forever. Both paths emitted agent/error but had no durable terminal to project. Retain the log offset of the latest exact-Agent live failure on the local activation. Clear it only when the same Session commits a turn/end at or after that offset, so a later recovery can supply its own outcome and a reentrant older terminal notification cannot erase a newer failure. The child scope owns both observers and removes them with its Agent handle. Capture error while that live failure remains. Let the failed local activation settle despite its own unclaimed inbox, while preserving the existing requirement to wait for owned descendants. Wake its settlement observer when a live failure changes readiness. No public API, raw Agent idle semantics, or descendant teardown policy changes. Add regressions through real local activation creation for first start/end append failures, recovery by later durable endings, exact-Agent isolation, and an error emitted reentrantly during an older terminal notification. Update the bilingual package contract and generated event consumer graph. Validation: - Both first-append regressions reproduced before the fix: turn/start remained pending; turn/end returned completed instead of error. - Six focused behavior cases passed after the fix. - 423 subagent package tests passed; activation.ts and manager.ts reached 100% statements, branches, functions, and lines under scoped coverage. - pnpm exec tsc -b packages/subagent/subagent/tsconfig.json passed. - Focused source/test oxlint and git diff --check passed. - doc-sync passed 41 gates; its sole stale event-graph failure was corrected with gen-doc-graphs, then verify-doc-graphs passed for all seven graphs. - README translation pairing regenerated and passed the doc-sync check.
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-plugintopic to your plugin repository for discoverability. - Join DeepSeek Harness Discord community.
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
Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.