kevchess15/deepseek-harness
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
2nd dokployH
5106 commits 1 branch 9 tags 143 MiB
Find a file
Tianyi Cui 3672cd25b4 feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 
Review direction (tianyicui, PR #660): in a stacked PR, change all other
process-running places to use the new service.

- lsp-local: LspConnection spawns through ctx.subprocess (piped protocol
  streams + a no-spill collected stderr tail); its private process-tree
  helpers (POSIX group signalling, Windows taskkill, liveness polling) are
  deleted in favor of the seam's handle verbs, and its buildChildEnv now
  rides scrubbedParentEnv (LSP children also stop inheriting stale DSH_*).
  The plugin injects 'subprocess'; compositions/tests mount
  dsh-subprocess-local.
- subagent-acp: the ACP child spawns through the seam (piped ndjson streams,
  inherited stderr); spawn failure surfaces through done-rejection into the
  same startup race; disposal is handle.dispose with the plugin's configured
  graces. dsh-subagent-subprocess is DELETED — its dispose ladder and scrub
  are the seam's, and the isolated-config-dir helper had no consumer.
- mcp-client, pty-local, sdk-helper: adopt scrubbedParentEnv as the one
  scrub definition (their spawns stay put by ownership: the MCP SDK and
  node-pty own those calls; the SDK wizard runs outside any composition).
- Coverage: per-file 100% over every touched src file, with each v8 ignore
  carrying a platform or contract reason; new suites cover stdio
  dispositions, the dispose ladder tiers, injected-win32 tree semantics,
  waitForExit, settled-kill/terminate no-ops, and spawn-failure disposal.
- Docs: consumer-migration Agent Note (en; zh follows in this PR), seam note
  updated in place, subprocess.md rewritten for the reshaped vocabulary
  (type-equiv re-registered), READMEs and SERVICE_ROLES updated, taskkill
  added to knip ignoreBinaries.
2026-07-26 15:27:59 +08:00
.agents feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +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 refactor(subprocess): rename the process seam to subprocess and address review 2026-07-26 12:43:59 +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 feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +08:00
examples feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +08:00
missions docs(missions): record workspace GUI closeout lessons 2026-07-25 17:46:05 +08:00
native docs(landlock-run): align source and release guidance 2026-07-20 12:25:43 +08:00
packages feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +08:00
python feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +08:00
scripts feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +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 feat(web): add workspace-aware session flow 2026-07-25 17:45:26 +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 fix(subprocess): finish the rename in current-state docs and graph inputs 2026-07-26 14:10:46 +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 feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +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 worktree/llm-mock-fault-server 2026-07-26 00:45:44 +08:00
pnpm-lock.yaml feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +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(subprocess): rename the process seam to subprocess and address review 2026-07-26 12:43:59 +08:00
tsconfig.client.json feat(web): add workspace-aware session flow 2026-07-25 17:45:26 +08:00
tsconfig.host.json feat(subprocess): migrate lsp-local, subagent-acp, and the env scrubs onto the seam 2026-07-26 15:27:59 +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 refactor(subprocess): rename the process seam to subprocess and address review 2026-07-26 12:43:59 +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