Quick Start

DSH Console requires Node.js 24 or newer, a working terminal, and pnpm on PATH to install its DSH profile. Install pnpm and the exact audited DeepSeek Harness and Console pair:

npm install --global pnpm@12.15.0
npm install --global @deepseek-ai/dsh@0.2.1-rc.2 @cofy-x/dsh-console@0.1.0-rc.4
dsh-console

The launcher resolves and checks the dsh executable selected from PATH before it initializes its owned dsh-console profile or changes the profile package. If the selected DeepSeek provider has no credential, the Console opens a masked setup dialog before it submits the first prompt.

This release supports DSH 0.2.1-rc.2 through the maximum tested version 0.2.1-rc.2. Console follows audited DSH releases, and that compatible prerelease can differ from npm latest; keep the exact versions in the installation command. Use dsh --version with command -v dsh on macOS/Linux, (Get-Command dsh).Source in PowerShell, or where dsh in Command Prompt to inspect the selected executable.

Plugin admission on newer releases is still governed by DSH compatibility checks; Console never grants version exemptions or bypasses Host restrictions.

The published launcher reconciles the exact installed Console package into its DSH profile. Running pnpm start from a source checkout resolves the checkout instead and is intended for development, not as a packaged-installation check.

You can also start with a prompt:

dsh-console --prompt "Explain this repository"

Continue the latest resumable Session for the current directory, or resume an exact Session ID before submitting an optional initial prompt:

dsh-console --continue
dsh-console --resume dsh-console-01234567-89ab-cdef-0123-456789abcdef --prompt "Continue this work"

The credential is written through the DSH credential service. DSH Console does not keep a separate authentication store and never writes a credential into a prompt or Session event.

First interaction

Type a prompt and press Enter. Assistant text streams into the transcript while reasoning, tools, todo state, attachments, and usage are projected into their dedicated TUI surfaces.

Type / to discover built-in Console commands and commands supplied by the active DSH profile. DSH commands such as /plan are available before the first prompt without creating an empty persisted Session.

During a running turn, Ctrl+C cancels the DSH operation. While idle, Ctrl+C disposes the runtime, restores the terminal, and exits.

Isolated environments

DSH_HOME controls the active profiles, JSONL Session logs, credentials, and attachment objects. Use an isolated value when testing:

DSH_HOME=/tmp/dsh-console-home dsh-console --prompt "hello"

Next, learn how to select a model and reasoning effort, resume a persisted Session, or review an agent plan.