2nd dokployH
Find a file
imccyu d5cd73a9d9 fix(gui): CI activation order + review-bot findings
The session-title snapshot exposed a real activation race: ui-trajectory
and ui-question register into conversation-declared slots but only
injected 'slots', so nothing ordered their applies after ui-conversation's
— register() into the undeclared slot threw and the entry FAILED. Both now
inject 'conversation' as an ordering edge (documented as such; specs stub
the service where the bench declares the slot itself).

Review-bot findings, all three applied: the module loader's load sink
cross-checks the handoff id against the arriving row (a mis-stamped bundle
can no longer register under another entry's identity); the default
execute seam removes the inline script node right after its synchronous
execution (repeated HMR rebuilds no longer accumulate dead nodes); a
throwing onRebuilt subscriber is contained per-listener and routed to
onError instead of escaping the fs.watchFile callback.
2026-07-24 02:09:43 +08:00
.agents docs(gui): client plugin loading RFC — final-state rewrite, bilingual pair 2026-07-24 02:09:42 +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 fix(gui): reconcile the rebase — ui-question joins the client roster 2026-07-24 02:09:42 +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 ci: coverage/knip 2026-07-24 02:09:43 +08:00
examples Merge remote-tracking branch 'origin/master' into worktree/pr540-merge-master-20260723 2026-07-23 22:34:49 +08:00
native docs(landlock-run): align source and release guidance 2026-07-20 12:25:43 +08:00
packages fix(gui): CI activation order + review-bot findings 2026-07-24 02:09:43 +08:00
python refactor(session-query): unify query service 2026-07-23 20:18:05 +08:00
scripts docs(gui): client plugin loading RFC — final-state rewrite, bilingual pair 2026-07-24 02:09:42 +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 Merge commit 'refs/codex-unblock/2026-07-23/base-511' into HEAD 2026-07-23 10:14:06 +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(gui): step1 skeleton — dsc web serves built web UI over booted harness host 2026-07-22 16:24: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 Revert "chore: run primary CI before push" 2026-07-23 14:02:58 +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 ci: coverage/knip 2026-07-24 02:09:43 +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 feat(gui): dsh-client-hmr reload driver and the dshClient-discovered watch-build script 2026-07-24 02:09:42 +08:00
pnpm-lock.yaml ci: coverage/knip 2026-07-24 02:09:43 +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): rebuild the client loading kernel as dsh-client-modules with a two-phase boot 2026-07-24 02:09:42 +08:00
tsconfig.client.json refactor(gui): rebuild the client loading kernel as dsh-client-modules with a two-phase boot 2026-07-24 02:09:42 +08:00
tsconfig.host.json Merge remote-tracking branch 'origin/master' into session-query-search 2026-07-23 13:56:56 +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 ci: drop covered files from the coverage exclude list 2026-07-24 02:09:43 +08:00
vitest.e2e.config.ts refactor(vitest): resolve every lane through the tsconfig.base.json facade 2026-07-23 03:59:06 +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 refactor(vitest): resolve every lane through the tsconfig.base.json facade 2026-07-23 03:59:06 +08:00

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