README
DSH Console
English | 简体中文
DSH Console is a keyboard-first, DSH-native terminal workbench for DeepSeek Harness. It combines durable sessions, structured tool and approval flows, plan and subagent views, local shell workflows, and rotating Pokémon startup art in a polished React/Ink interface.

[!WARNING]
DSH Console is currently a public prerelease. Its DSH contracts and persisted sessions are real, but commands and UI details may still change before the first stable release.
Quick start
DSH Console requires Node.js 24 or newer and pnpm on PATH to install its DSH profile. Install pnpm and the exact audited DeepSeek Harness and DSH Console pair:
npm install --global pnpm@12.15.0
npm install --global @deepseek-ai/dsh@0.2.2-rc.4 @cofy-x/dsh-console@0.1.0-rc.5
dsh-console
The dsh-console launcher first resolves the dsh executable selected from PATH and checks its version, then initializes its owned DSH profile and keeps the profile package aligned with the installed launcher version before starting the interactive TUI. Run dsh --version plus command -v dsh on macOS/Linux, (Get-Command dsh).Source in PowerShell, or where dsh in Command Prompt to inspect the selected installation.
To use an existing DSH profile with your own provider, model, or tools, select it before Console arguments:
dsh-console --profile my-profile --prompt "hello"
--profile <name> takes precedence over DSH_CONSOLE_PROFILE; otherwise the launcher uses its managed dsh-console profile. Create a custom profile with DSH first (for example, dsh plugin --profile my-profile add @cofy-x/dsh-console@0.1.0-rc.5, which requires pnpm on PATH). The launcher installs or updates only its Console bundle in the selected profile; DSH still owns providers, credentials, packages, and patches. Profiles under the same DSH_HOME share Sessions, credentials, settings, and attachments; use a separate DSH_HOME for isolation. Missing or invalid custom profiles fail rather than silently falling back. From a source checkout, invoke node apps/cli/bin/dsh-console.js --profile my-profile; pnpm start is a separate development path.
This Console release supports DSH 0.2.2-rc.4 through the maximum tested version 0.2.2-rc.4. DSH Console follows audited DSH releases, and a compatible prerelease can differ from npm latest, so the installation command pins both products exactly. Older DSH releases are rejected before profile changes; newer unaudited releases produce a warning but remain available for user-directed testing.
Plugin admission on newer releases is still governed by DSH compatibility checks; Console never grants version exemptions or bypasses Host restrictions.
Start directly with a prompt:
dsh-console --prompt "hello"
Continue the latest resumable Session for the current directory, or resume an exact Session ID. An initial prompt can be supplied after either option:
dsh-console --continue
dsh-console --resume dsh-console-01234567-89ab-cdef-0123-456789abcdef --prompt "continue this work"
If the official DeepSeek provider is missing a credential that DSH can configure, DSH Console opens a masked setup dialog before submitting the first prompt and writes the credential through DSH. DSH controls credential precedence and writability; saved DeepSeek credentials take precedence over environment values, and writable environment-backed credentials can be replaced through DSH. Providers without a Console setup adapter continue to use their existing DSH configuration paths. DSH Console never maintains a separate credential store.
Public prereleases use versions such as 0.1.0-alpha.x and 0.1.0-rc.x while the current published Console remains available through npm's default install path.
A published package launch uses the globally installed launcher and reconciles its exact package into the dsh-console profile. A source checkout launch with pnpm start resolves that checkout instead; it is a development path and does not prove the behavior of the published package.
What you get
- Streaming, multi-turn conversations with Markdown, reasoning, interruption, and usage display
- DSH tool calls, results, approvals, questions, todo state, and browsable
/toolsand/skillscatalogs - Per-Session DSH Agent composition with
/preset, including deterministic restoration - DSH-native model selection, image input from
@pathor the clipboard, and isolated prompt completion - Persistent DSH sessions with startup continuation,
/new, and/sessions - Local shell mode, themes, settings, terminal-safe cleanup, and continued operation in a regular PTY or embedded terminal such as Orca
Interactive commands
| Command | Purpose |
|---|---|
/model |
Select the active DSH model |
/new |
Start a fresh conversation |
/sessions |
Search, preview, rename, resume, or fork workspace Sessions |
/jobs |
Inspect and stop background jobs for the current Session |
/goals |
Manage the Session goal, activation, and round limit |
/tools |
Inspect tools exposed by the active DSH agent |
/skills |
Inspect and discover user-invocable DSH Skills |
/preset |
Show or change the blank Session's DSH Agent preset |
/theme |
Select the terminal theme |
/settings |
Edit Console settings |
!command |
Run a command locally without submitting it to the model |
更多「命令行与终端」插件
deepseek-harness-docker
作者 runzhliu
社区 Docker 与 Kubernetes 打包,含加固镜像、Compose、Helm、Web UI 与无头 CLI。
deepseek-harness-android
作者 dphmoblie
dsh安卓版:集成 DeepSeek Harness、Ubuntu 运行环境、插件与文件管理,以及用户授权的 Shizuku 和无障碍自动化。
dsh-subagent-codex
作者 mjylfz
让 DeepSeek Harness 以 Codex CLI 作为子代理的插件,在对话中复用 Codex 的编码与推理能力。
mnemon
作者 mnemon-dev
LLM 监督的持久记忆系统,基于图结构召回、跨会话知识共享,单个二进制文件,兼容 DeepSeek Harness 等运行时。
