Skip to content

Quick Start

DSH Console requires Node.js 24 or newer and a working terminal. Install DeepSeek Harness and the Console from npm:

Terminal window
npm install --global @deepseek-ai/dsh @cofy-x/dsh-console
dsh-console

The launcher initializes or locates the dsh-console DSH profile and opens the interactive TUI. If the selected DeepSeek provider has no credential, the Console opens a masked setup dialog before it submits the first prompt.

You can also start with a prompt:

Terminal window
dsh-console --prompt "Explain this repository"

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.

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.

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

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

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

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