dsh-tui/dsh-tui
151Last commit Aug 14, 2026
dsh-tui DSH plugin
dsh-tui provides a Claude Code / Codex-style chat interface in your terminal. It composes over the official @deepseek-ai/dsh-base bundle, sharing the same plugin ecosystem for shell, filesystem, skills, subagents, workflows, and sandbox approvals. Built on @earendil-works/pi-tui, it offers streaming model output, tool-call cards, and various interactive dialogs.
How to install the dsh-tui DSH plugin
dsh plugin --profile tui add @dsh-tui/dsh-tuiCopying does not run this command. Review the repository and version before installing the dsh-tui DSH plugin.
dsh-tui DSH plugin data source
dsh-tui DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-tui DSH plugin can do
- Streaming model output and reasoning rendered as Markdown
- Tool-call cards with terminal/diff/generic render intents; Ctrl+O cycles collapsed → expanded → hidden
- Approval and ask_user_question dialogs, including plan-mode review
- @file path autocomplete and @session reference cards
- Slash commands: /model (with reasoning-effort selection), /resume, /compact, /details, /help, plus commands from other plugins
- Standing todo panel, token usage/context-pressure status line, session titles
- Configurable truecolor theme (detected from COLORTERM)
Where the dsh-tui DSH plugin fits
- Start a new chat session with a DeepSeek model in the terminal
- Resume a previously persisted session using --resume <session-id>
- Switch models or adjust reasoning effort via /model command
- Compact session context to manage token usage
- Review and approve tool calls or answer user questions during plan-mode
Who the dsh-tui DSH plugin is for
- Developers using DeepSeek Harness who prefer a terminal-based interface
- Advanced users comfortable with CLI tools and dsh plugin ecosystem
dsh-tui DSH plugin limitations
- Under active development against pre-release @deepseek-ai/dsh; expect breakage until upstream stabilizes
- Test suite (tests/) predates the port and does not run yet
- A real model turn requires a reachable DeepSeek-compatible endpoint; everything up to the request works keyless
dsh-tui DSH plugin: from the repository README
Quoted from the dsh-tui/dsh-tui README, the upstream source of the dsh-tui DSH plugin. Copyright remains with the original authors.
English | [中文](README.zh.md) An interactive terminal (TUI) front door for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) agents — a Claude Code / Codex-style chat interface in your terminal, installed as an out-of-tree dsh plugin bundle. Built on [`@earendil-works/pi-tui`](https://www.npmjs.com/package/@earendil-works/pi-tui). It composes over the official `@deepseek-ai/dsh-base` bundle, so the whole plugin ecosystem — shell and filesystem tools, skills, subagents, workflows, sandbox approvals — is the same one the official web surface uses. Nothing is forked.  ## Features - Streaming model output and reasoning, rendered as Markdown - Tool-call cards with terminal / diff / generic render intents; Ctrl+O cycles collapsed → expanded → hidden - Approval and `ask_user_question` dialogs, plan-mode review included - `@file` path autocomplete and `@session` reference cards - Slash commands: `/model` (with reasoning-effort selection), `/resume`, `/compact`, `/details`, `/help`, and every command other plugins register - Standing todo panel, token usage and context-pressure status line, session titles - Configurable theme; truecolo
Read the full READMERepository license: NOASSERTION
dsh-tui DSH plugin questions
How do I install dsh-tui?
First install the dsh CLI globally: `npm i -g @deepseek-ai/dsh@next`. Then run `dsh plugin --profile tui add @dsh-tui/dsh-tui`. To start a session, use `dsh --profile tui`. If you want to track the GitHub repo instead of the npm release, use `add github:dsh-tui/dsh-tui` and follow the printed build permission instructions.
How do I set my API key for dsh-tui?
Set the `DEEPSEEK_API_KEY` environment variable. You can also place a `.env` file in the launch directory or in `$DSH_HOME`. The plugin will read the key from these locations automatically.
Can I use a local or self-hosted DeepSeek endpoint with dsh-tui?
Yes. You can set `DEEPSEEK_BASE_URL=http://localhost:8000/v1` as an environment variable alongside your API key. Alternatively, configure it in `$DSH_HOME/settings.yaml` under `llm-deepseek.baseURL`. For OpenAI-compatible gateways like vLLM or SGLang, declare an `llm-pi-ai` route in your profile patch (`cordis.patch.yml`) and point the default model to it.
How do I resume a previous session?
Use the `--resume <session-id>` flag when starting dsh-tui: `dsh --profile tui --resume <session-id>`. The session ID is typically shown in the status line or can be found from your session history.
What slash commands are available in dsh-tui?
Built-in commands include `/model` (with reasoning-effort selection), `/resume`, `/compact`, `/details`, `/help`, and `/reply`. The plugin also registers any commands that other plugins provide. You can type `/help` in the chat to see the full list.