DeepSeek Harness for VS Code

Your DSH workspace, right beside your code.

English | 简体中文

DeepSeek Harness Companion for VS Code is a native VS Code client for
DeepSeek Harness (DSH), DeepSeek's local coding
agent. It brings sessions, streaming replies, thinking, and tool progress into the side bar so you
can stay in the editor and stay in flow.

Highlights

• Sessions & context — create, switch, resume, and archive sessions per workspace.
• A clear timeline — user input, model replies, collapsed thinking, tool calls, approvals, and
  error states each render distinctly.
• Control — use the models, providers, reasoning levels, permission presets, and plan settings
  that your DSH instance provides.
• Context-aware work — send text, images, and workspace files; reference files and sessions
  with @; handle approvals and user questions in place.
• Close the loop — leave a rating and note on replies, and open files produced or modified by
  tools directly.
• Reliable recovery — automatic local DSH discovery with reconnect, deduplication, history gap
  backfill, and redacted diagnostics.
• Local productivity extras — prompt templates, checkpoints, a Changes drawer, and a task
  center, all handled host-side and triggered only by explicit user action.

Install

From the VS Code Marketplace — install
DeepSeek Harness Companion for VS Code
or search for DeepSeek Harness in the Extensions view.

From GitHub Releases — download deepseek-harness-vscode-universal.vsix (or a
platform-specific build: linux-x64, windows-x64, darwin-x64, darwin-arm64) from the
latest release, then run
Extensions: Install from VSIX... in VS Code.

Get started

1. If DSH is not installed yet, run npm install --global @deepseek-ai/dsh (requires Node.js
   22.19+), or press the guided install action in the view.
2. Open the DeepSeek Harness view in VS Code.
3. Choose or create a workspace, start a session, and send your task.

The extension discovers a compatible local DSH automatically. When none is found it offers guided
actions to install DSH, select an existing executable, copy the install command, or open the
documentation. Discovery always completes before anything is started, and a DSH the extension does
not own is never stopped.

Connection modes

Runtime updates

The General settings page checks the npm upstream at startup and can install one exact version from
the verified list. Updating never stops an external DSH; when a custom executable is selected, the
global package update requires selecting or reconnecting the runtime before it is used.

Compatibility

Available models, tools, and advanced agent capabilities follow the connected DSH instance;
unsupported capabilities are surfaced clearly instead of failing silently.

Privacy & security

Connections, file access, credentials, and process ownership stay in the VS Code Extension Host.
The Webview receives no secrets and no direct filesystem or network access, logs follow an
allowlist with prompt/body/token redaction, and every DSH endpoint must be a verified loopback
address. See docs/security.md for the full trust model.

Documentation

Developer documentation lives in docs/, starting from the
index:

Development

Requires Node.js >=22.19 <27 and pnpm 11.19 (pinned through packageManager):

corepack enable
pnpm install --frozen-lockfile
pnpm check   # format + lint + typecheck + tests
pnpm build
pnpm package:vsix

See CONTRIBUTING.md for change discipline and PR evidence requirements, and
docs/development.md for debugging and live DSH integration modes.

• Pull requests and pushes to main run cross-platform CI on Linux, Windows, and macOS.
• Pushing a v* tag packages VSIX files for Linux, Windows, and macOS (plus a universal build),
  creates a GitHub Release, and publishes the extension to the Visual Studio Marketplace.

Changelog & license

User-facing changes are tracked in
apps/extension/CHANGELOG.md and mirrored on the
Releases page. Licensed under the
MIT License.