dsh-code

DSH-Code

English | 中文 1. Project overview

DSH-Code is a terminal coding interface for DeepSeek Harness (dsh). It is composed as an out-of-tree bundle on top of the official @deepseek-ai/dsh-base and uses the same Agent, Session, tool, command, skill, permission, sandbox, context-compaction, and plugin services as the Harness Web UI.

DeepSeek Harness registers models, tools, storage, policies, and interfaces as plugins through Cordis. Durable session events record the information required to restore conversations and runtime state. DSH-Code preserves that architecture while adding a terminal workflow suited to coding tasks. The interface follows terminal conventions familiar to developers, while runtime behavior remains governed by DSH services and configuration. 2. Quick start

2.1.0 release notes

Requires Node >=24.9.0 and the preview dsh CLI (current release line: @deepseek-ai/dsh@0.2.2-rc.1). You can still enter the TUI, browse sessions, and use non-model features without configuring a model; press Tab in /model to manage API keys, OAuth, device-code sign-in, endpoints, and models. 1. Install and update

The commands below install the published dsh-code@2.1.0 with its matching Harness version. This checkout targets Harness 0.2.2-rc.1; use the source installation below for this checkout. Close all running dsh / deepseek sessions before installing or upgrading.

Use /update or deepseek update --apply for later updates. See installation and upgrade troubleshooting for version alignment, dependency repair, and migration errors. 2. Launch commands

Available launch commands:

dsh --profile cli, deepseek, and dsh-code are equivalent launch commands. deepseek and dsh-code are global aliases for dsh --profile cli, and all additional arguments are forwarded unchanged, for example deepseek --resume abc123. DeepSeek Harness is still a developer preview and may introduce compatibility-breaking changes. DSH-Code will continue to track the evolution of its plugin interfaces. 3. Core features and usage

DSH-Code brings DSH Agents, models, tools, and durable sessions directly into the terminal, covering the complete workflow from writing code to reviewing changes. 1. Session management Create sessions with /new, or restore existing sessions with /resume and --continue Create a new work branch from a historical point with /fork while preserving the original session Search history by current directory, update time, and session scope Recall input history with Up/Down (typed slash commands included), or search previous prompts and commands with /history Use persistent titles, Markdown export, context occupancy, token, cache, TTFT, and elapsed-time metrics; /usage reports the harness token meter's four disjoint buckets, the totals merged by model, and a per-turn breakdown The status bar's in counts only uncached input, and cache shows both the cache-read volume and the hit share — together they are the billed prompt side Restore the session's Agent Preset, model selection, and subagent list when resuming it; the welcome header shows both the dsh and dsh-code versions