dsh-console

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 alpha. Its DSH contracts and persisted sessions are real, but commands and UI details may still change before the first stable release.

Quick start

With Node.js 24 or newer, install the exact audited DeepSeek Harness and DSH Console pair:

npm install --global @deepseek-ai/dsh@0.1.6-alpha.2 @cofy-x/dsh-console@0.1.0-alpha.17
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.

This Console release supports DSH 0.1.6-alpha.2 through the maximum tested version 0.1.6-alpha.2. 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.

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. Read-only environment credentials and providers without a Console setup adapter continue to use their existing DSH configuration paths. DSH Console never maintains a separate credential store.

Public Alpha releases use prerelease versions such as 0.1.0-alpha.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 /tools and /skills catalogs
• Per-Session DSH Agent composition with /preset, including deterministic restoration
• DSH-native model selection, image input from @path or 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

During an active turn, Ctrl+C cancels the current DSH operation. While idle, Ctrl+C disposes the runtime, restores the terminal, and exits.

Sessions and local data

DSH is the source of truth for conversation history. DSH Console lists resumable dsh-console-* conversations and their persistent forks for the current working directory, replays their canonical DSH event surface, and resumes them through DSH. It does not maintain a parallel client-owned session database.

The active DSH_HOME controls profiles, JSONL session logs, and attachment objects. Set it to isolate an environment:

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

DSH-native by design

DeepSeek Harness owns agent execution, models, provider settings and credentials, sessions, tools, approvals, attachments, persistence, and canonical events. DSH Console owns terminal interaction, input preparation, presentation, and focused adapters to those public DSH services.

• Runtime adapters consume official DSH canonical types and project them into stable Console view models before React renders them.
• Session replay and live streaming share the same event projector, keeping text, reasoning, tools, todo state, usage, errors, and interruptions consistent.
• Images are admitted through the DSH attachment service before a user turn is created; failed admission never degrades silently to text-only input.
• Prompt completion uses a separate temporary agent/session and never writes to the active conversation.

The published package contains the launcher, compiled Console runtime, DSH plugin bundle, license, and attribution notices. Runtime plugins remain provided by the selected DSH profile.

Alpha boundaries

The current release intentionally does not provide cross-directory session search, session deletion, generic file/PDF/audio/video attachments, native terminal image protocols, a web UI, or a standalone provider/auth layer.

Background jobs, goals, and reusable history

/jobs observes jobs owned by the currently interactive Session and confirms stop requests without consuming the Agent's output cursor or completion notices. Job output remains owned by DSH and the Agent's job_output flow. /goals creates, edits, pauses, resumes, completes, and clears the native DSH goal, with an editable round limit rather than a token or money budget. Restored goals stay disarmed until explicitly resumed. Native /goal ... commands and their attachment semantics remain unchanged.

In /sessions, press / to search titles, ids, and canonical conversation text, then Enter for a paged preview and actions. User renames are persisted and pinned by DSH. A persistent fork inherits a completed Turn prefix, its model route, and source Agent composition; it is flushed before switching, preserves lineage, changes no files, and starts no prompt automatically. Forks remain discoverable and resumable after restart.

Full-text search opens a DSH-managed, rebuildable SQLite index under DSH_HOME on first use, keeping startup lazy. JSONL logs remain the durable source of truth, and explicit user profile overrides still take precedence.

Development

Install the workspace and run the same entry point exposed by the published package:

pnpm install --frozen-lockfile
pnpm run build:cli
pnpm start -- --prompt "hello"

Development requires Node.js 24 or newer and pnpm 11. The main quality checks are:

pnpm run format:check
pnpm run lint
pnpm run typecheck
pnpm run build:cli
pnpm run test:ci
pnpm run test:integration:dsh
pnpm run test:package

format:check incrementally checks changed files without modifying them. test:integration:dsh composes the real Cordis/DSH runtime with a deterministic fake LLM adapter. test:package packs the public package, installs it in an isolated directory, initializes an isolated DSH_HOME, and exercises the installed launcher.

License and attribution

DSH Console is licensed under the Apache License 2.0. See LICENSE, NOTICE, and THIRD_PARTY_NOTICES.md. Portions of the terminal UI and supporting utilities are derived from Gemini CLI and retain their original copyright notices.