woodwhite0ets/dshtui-by-woodwhite
deepseek harness tui by woodwhite
An interactive terminal (TUI) front door for DeepSeek Harness agents — a Claude Code / Codex-style chat interface in your terminal, installed as an out-of-tree dsh plugin bundle. It composes over the official @deepseek-ai/dsh-base bundle, so the same plugin ecosystem (shell and filesystem tools, skills, subagents, workflows, sandbox approvals) backs it as the official web surface, with nothing forked. Features include 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 with plan-mode review, @file path autocomplete and @session reference cards, slash commands (/model with reasoning effort, /resume, /compact, /details, /help, plus any command other plugins register), a standing todo panel, token usage and context-pressure status line, session titles and a configurable theme with truecolor detection.
Install
dsh plugin --profile tui add github:woodwhite0ets/dshtui-by-woodwhiteREADME install documents the npm form dsh plugin --profile tui add @woodwhite0ets/dsh-tui followed by dsh --profile tui (requires Node ^22.19 || >=24 and the dsh CLI, e.g. npm i -g @deepseek-ai/dsh@next). That npm name did not resolve on registry.npmjs.org on 2026-09-12, so the GitHub form shown here is the registry-verified one; the README documents add github:woodwhite0ets/dshtui-by-woodwhite as the way to track the repo instead of the release. Git-hosted plugins build on install via their prepare script, which pnpm blocks until you allow it — if the add fails, append the key it prints under allowBuilds in ~/.dsh/profiles/tui/pnpm-workspace.yaml and re-run. Set DEEPSEEK_API_KEY in the environment or a .env in the launch directory / $DSH_HOME.
Compatibility
Node ^22.19 || >=24; the dsh CLI; a tui profile. README status note: under active development against the pre-release @deepseek-ai/dsh rc line with breakage expected until upstream stabilizes; peer dependencies pin the tested rc. pi-tui is pinned at 0.80.7 with a pnpm patch and bundled into lib/ so installs outside the repo never see an unpatched copy.
Details
- Repo: woodwhite0ets/dshtui-by-woodwhite
- Category: Web UI Enhancements
- Stars: 0
- Version: GitHub install (README documents both an npm form and the GitHub form; the npm name @woodwhite0ets/dsh-tui returned 404 on registry.npmjs.org on 2026-09-12, so the GitHub form is the registry-verified install here)
- Last push: 2026-08-14
- First seen: 2026-08-14
Recent updates
README provenance note: the TUI implementation was recovered from the DeepSeek Harness repository history (packages/ui/tui, removed upstream in commit 10bb9cbf4a) and ported to the published rc API, with upstream copyright preserved in LICENSE. Self-hosted DeepSeek endpoints need no code changes — use DEEPSEEK_BASE_URL alongside DEEPSEEK_API_KEY, a hot-reloaded $DSH_HOME/settings.yaml llm-deepseek.baseURL, or an llm-pi-ai route for OpenAI-compatible gateways.
FAQ
- How do I install dsh-tui by woodwhite?
- Run dsh plugin --profile tui add github:woodwhite0ets/dshtui-by-woodwhite, allow the build if pnpm asks, then start dsh --profile tui (or dsh --profile tui --resume <session-id>). The README's npm form used the name @woodwhite0ets/dsh-tui, which returned 404 on npm on 2026-09-12.
- Does it reuse the official plugin ecosystem?
- Yes — it composes over the official @deepseek-ai/dsh-base bundle, so shell and filesystem tools, skills, subagents, workflows and sandbox approvals are the same ones the official web surface uses; nothing is forked.
- Can I point it at a local model server?
- Yes, with no code changes: set DEEPSEEK_BASE_URL=http://localhost:8000/v1 alongside DEEPSEEK_API_KEY, or use a hot-reloaded $DSH_HOME/settings.yaml with llm-deepseek.baseURL for OpenAI-compatible gateways.