kevchess15/deepseek-harness
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
2nd dokployH
5245 commits 1 branch 9 tags 143 MiB
Find a file
Tianyi Cui 34aabc4183 test(sdk): snapshot suite over the SDK path; docs for the SDK stack 
- examples/jsonrpc-agent gains its first snapshot suite (sdk.snapshot.ts):
  the real dsh-jsonrpc-agent runtime driven through the real dsh-sdk-client,
  keyless llm-replay behind a new cordis.snapshot.yml overlay; three recorded
  scenarios (text turn, bash tool, spawn subagent) pin the notification
  stream, the SDK turn result, and the persisted parent+child session logs.
- Bilingual READMEs for dsh-sdk-protocol / dsh-sdk-client / dsh-subagent-sdk;
  sdk/ and subagent/ group tables extended; dsh-jsonrpc README points at the
  extracted protocol package; Agent Note (en+zh) owns the decision.
- The proposed make-jsonrpc-directional note is updated for the transport's
  new home and its second (client) consumer.
- Model Experience sentence allowlist entries for the two client-side
  packages; module graph + config catalog regenerated; i18n pairings
  recorded. doc-sync passes 24/24.
2026-07-27 04:37:23 +08:00
.agents test(sdk): snapshot suite over the SDK path; docs for the SDK stack 2026-07-27 04:37:23 +08:00
.claude docs: accuracy sweep, architecture restructure, two ADRs, review skill 2026-06-13 22:05:34 +08:00
.github ci: reuse the primary Linux build 2026-07-23 18:02:17 +08:00
apps Merge branch 'master' into worktree-tasks-service-seam 2026-07-26 22:57:38 +08:00
assets docs: make the top-level README product-first 2026-07-23 00:15:44 +08:00
bin refactor: drop obsolete expose-internals flag 2026-07-23 20:35:09 +08:00
docs test(sdk): snapshot suite over the SDK path; docs for the SDK stack 2026-07-27 04:37:23 +08:00
examples test(sdk): snapshot suite over the SDK path; docs for the SDK stack 2026-07-27 04:37:23 +08:00
native docs: translate remaining READMEs 2026-07-26 05:06:39 +08:00
packages test(sdk): snapshot suite over the SDK path; docs for the SDK stack 2026-07-27 04:37:23 +08:00
python feat(sdk): TypeScript SDK client + shared wire protocol + SDK subagent backend 2026-07-27 03:21:06 +08:00
scripts test(sdk): snapshot suite over the SDK path; docs for the SDK stack 2026-07-27 04:37:23 +08:00
skills/create-dsh-sdk-project Remove the stdio agent 2026-07-20 19:26:04 +08:00
vendor fix(vendor/include): keep config reloads resilient 2026-07-22 17:50:45 +08:00
website docs(site): publish translated core data pages 2026-07-24 18:07:56 +08:00
.editorconfig Declare LF and final-newline conventions in .editorconfig 2026-07-15 16:09:12 +08:00
.gitattributes Pin LF working trees via .gitattributes 2026-07-15 16:09:12 +08:00
.gitignore docs(skills): record-browser-gif — assets-branch publishing + mandatory GUI-PR gifs 2026-07-26 23:21:44 +08:00
.gitlab-ci.yml python: derive release version from repository 2026-07-13 17:49:01 +08:00
.jscpd.json chore: tighten TypeScript duplication lint 2026-07-14 00:24:04 +08:00
AGENTS.md docs: preserve incremental PR retarget checkpoints 2026-07-26 21:59:03 +08:00
CLAUDE.md Initialize repo with README, AGENTS.md, and CLAUDE.md symlink 2026-06-10 22:58:56 +08:00
eslint.config.mjs fix(ci): isolate lint from NodeNext temp consumers 2026-07-23 16:57:59 +08:00
knip.json test(subagent-sdk): keyless Loader-composition e2e across the SDK wire 2026-07-27 03:59:46 +08:00
lefthook.yml Revert "chore: run primary CI before push" 2026-07-23 14:02:58 +08:00
LICENSE Initialize repo with README, AGENTS.md, and CLAUDE.md symlink 2026-06-10 22:58:56 +08:00
package.json Merge branch 'master' into fix-update-builderror 2026-07-26 02:39:35 +08:00
pnpm-lock.yaml test(sdk): snapshot suite over the SDK path; docs for the SDK stack 2026-07-27 04:37:23 +08:00
pnpm-workspace.yaml Merge latest master through rfc/pty into feature/persistent-pty-sessions 2026-07-22 21:21:58 +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 fix(demo): build client plugin bundles before serving dsh web 2026-07-23 16:37:56 +08:00
README.md fix(demo): build client plugin bundles before serving dsh web 2026-07-23 16:37:56 +08:00
README.zh.md fix(demo): build client plugin bundles before serving dsh web 2026-07-23 16:37:56 +08:00
tsconfig.base.client.json refactor(tsconfig): single root solution graph over host/client aggregates 2026-07-23 03:59:05 +08:00
tsconfig.base.json refactor(gui): copy-free settings shell; ui-settings-general owns ownerless copy 2026-07-26 12:40:17 +08:00
tsconfig.client.json refactor(gui): copy-free settings shell; ui-settings-general owns ownerless copy 2026-07-26 12:40:17 +08:00
tsconfig.host.json feat(sdk): TypeScript SDK client + shared wire protocol + SDK subagent backend 2026-07-27 03:21:06 +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(tsconfig): single root solution graph over host/client aggregates 2026-07-23 03:59:05 +08:00
vitest.config.ts Merge branch 'master' into worktree/dsh-arg-parser 2026-07-25 17:48:21 +08:00
vitest.e2e.config.ts refactor(cli): unify the arg grammar — one program, --config flag, real web subcommand 2026-07-25 15:47:55 +08:00
vitest.snapshot.config.ts Merge remote-tracking branch 'origin/master' into worktree/pr348-retarget-latest-master 2026-07-23 22:46:19 +08:00
vitest.web.config.ts Merge remote-tracking branch 'origin/master' into web-e2e-lane 2026-07-25 18:19:22 +08:00

README.md

DeepSeek Harness

English | 中文

DeepSeek Harness (dsh) is an open-source coding agent built on the DeepSeek Harness SDK.

It uses an architecture where everything is a plugin.

Install

Install dsh with one command:

curl -fsSL https://raw.githubusercontent.com/deepseek-harness/deepseek-harness/master/scripts/install.sh | sh

The installer requires git and Node ^22.19 || >=24, offers to install pnpm when it is missing, and prompts for a DeepSeek API key.

The installer clones DeepSeek Harness to ~/.dsh/source, links dsh into ~/.local/bin, and launches it. Re-running the command updates the checkout. See scripts/install.sh for alternate install locations and other options.

Use DeepSeek Harness

Web UI

For the recommended local interface, build the frontend after installation and after each update, then start the Web UI:

pnpm --dir ~/.dsh/source run build && pnpm --dir ~/.dsh/source run build:web
dsh web

The Web UI is served at http://127.0.0.1:3080 by default.

TUI

Start the full-screen terminal interface:

dsh

Headless

Run one task, print the final answer, and exit:

dsh -p "summarize this workspace"

Why DeepSeek Harness

Built-in capabilities cover file reading, editing, and search; shell execution; reusable skills; task tracking; subagents and workflows; persistent sessions; and context compaction. The TUI also includes Plan Mode.

  • Everything is a plugin. Models, tools, policies, storage, context management, and interfaces are composable Cordis plugins, so deployments can extend or replace behavior without forking the agent loop. See the architecture for the underlying design.
  • Code Mode (opt-in). It exposes a run_code tool and a generated TypeScript SDK; only program output re-enters model context. See Code Mode.
  • Self-referential Cordis tools are opt-in. They let the agent inspect its live runtime and mount or unmount plugins while it runs. See the Cordis tools.

Community

Follow DeepSeek Harness on Twitter for project updates.

Development

pnpm install
pnpm run test:coverage

Start with the development guide and read the architecture before changing packages.

For agents, follow AGENTS.md.

DeepSeek Harness is currently pre-release.

License

BSD 3-Clause