kevchess15/deepseek-harness
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
2nd dokployH
5423 commits 1 branch 9 tags 143 MiB
Find a file
Tianyi Cui d2edfcca2e Merge pull request #624 from deepseek-harness/worktree/llm-reasoning-effort 
feat(llm): add dynamic model-specific reasoning efforts including off
2026-07-27 15:37:54 +08:00
.agents Merge branch 'master' into worktree/llm-reasoning-effort 2026-07-27 15:30:00 +08:00
.claude
.github ci: restore standard Windows allocation 2026-07-27 02:31:46 +08:00
apps Merge branch 'master' into worktree/llm-reasoning-effort 2026-07-27 15:30:00 +08:00
assets
bin
docs Merge branch 'master' into worktree/llm-reasoning-effort 2026-07-27 15:30:00 +08:00
examples Merge branch 'master' into worktree/llm-reasoning-effort 2026-07-27 15:30:00 +08:00
native
packages Merge branch 'master' into worktree/llm-reasoning-effort 2026-07-27 15:30:00 +08:00
python refactor(tasks): split the task registry into seam and local implementation 2026-07-26 05:13:39 +08:00
scripts Merge remote-tracking branch 'origin/master' into worktree/llm-reasoning-effort 2026-07-27 13:35:10 +08:00
skills/create-dsh-sdk-project
vendor
website
.editorconfig
.gitattributes
.gitignore chore 2026-07-27 09:06:19 +08:00
.gitlab-ci.yml
.jscpd.json
AGENTS.md Merge remote-tracking branch 'origin/master' into worktree-nih-dependency-audit 2026-07-27 04:59:50 +08:00
CLAUDE.md
eslint.config.mjs
knip.json
lefthook.yml
LICENSE
package.json Merge remote-tracking branch 'origin/master' into worktree-i18n-update-workflow 2026-07-27 09:39:54 +08:00
pnpm-lock.yaml feat: slash system / input service / agent scope 2026-07-27 03:28:39 +08:00
pnpm-workspace.yaml
pytest.ini
README.i18n.yaml
README.md
README.zh.md
tsconfig.base.client.json
tsconfig.base.json feat: slash system / input service / agent scope 2026-07-27 03:28:39 +08:00
tsconfig.client.json feat: slash system / input service / agent scope 2026-07-27 03:28:39 +08:00
tsconfig.host.json Merge branch 'master' into worktree-tasks-service-seam 2026-07-26 22:57:38 +08:00
tsconfig.json
tsdown.config.ts
vitest.config.ts test: defer coverage for the four new client plugin entry files 2026-07-27 08:30:57 +08:00
vitest.e2e.config.ts
vitest.snapshot.config.ts
vitest.web.config.ts

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