DEEPSEEK HARNESS · TERMINAL EDITION

DeepSeek Harness.Right in your terminal.

Read code, run tools, and build with your agent. A focused terminal workspace, powered by DeepSeek Harness.

macOS · Linux · Windows TerminalRuntime 0.2.1-rc.5

dsh-tui Interface preview
> fix the failing scroll test
Completed · process details
⏺ read_file({"file_path":"src/render/scroll.ts"}) ✓ 84 lines
⏺ edit_file({"file_path":"src/render/scroll.ts"}) ✓
⏺ bash("pnpm vitest run scroll") ✓ 12 passed
Result

✔ estimateEntryRows now counts the (+N more) row

Ask dsh anything…
tui-01e62198deepseek-v4-flashworkspace-write
One request, a visible process, a clear result.

BUILT FOR THE WAY YOU WORK

Less switching. More building.

Stay close to your code. Choose a model, bring your tools, and pick up where you left off.

Slash commands with pickers

/model , /permission , /mcp add and /skill open pickers over what is actually mounted, so you pick a name instead of guessing one.

Shell escapes

!git status runs it and shows the output; !! also hands it to the model. !cd moves the working directory and stays moved.

File mentions

@src/pro + Tab completes the path into your message. Nothing is read behind your back — the model opens the path with its own tools.

Image attachments

Drop an image on the terminal and the path is pulled out of the text and sent as an attachment, with a chip confirming what went.

Approvals that leave a record

A tool call that needs you gets a card with its arguments. The answer stays in the transcript, so a resumed session never shows a call that silently never ran.

Skills

/skill lists the user-invocable skills your assembly mounted. Tab fills the line, Enter runs it.

Sessions you can pick up

/sessions lists what is stored, /resume last goes back to the newest, and /history hide starts the transcript at the new work.

Fits the room

/theme dark|light follows an OSC 11 probe of your terminal, /language en|zh switches the chrome, /keybinds vim adds a normal mode.

GET STARTED

A familiar terminal. A ready workspace.

Choose your shell, install the matching runtime, then connect your model.

Full install guide, API key steps and recovery
Node ≥ 22.19npm + Gitcurl / curl.exe

Install for your terminal

macOS / Linux
curl -fsSL --connect-timeout 15 --max-time 120 https://raw.githubusercontent.com/Qyn77/dsh-tui/main/install.sh | bash

macOS / Linux

Windows · PS7
curl.exe -fsSL --connect-timeout 15 --max-time 120 https://raw.githubusercontent.com/Qyn77/dsh-tui/main/scripts/install.mjs -o "$env:TEMP\dsh-tui-install.mjs" && node "$env:TEMP\dsh-tui-install.mjs"

Windows PowerShell 7

curl.exe downloads the script, then Node runs it. Install PowerShell 7 first; launch the TUI in Windows Terminal + PowerShell 7. This is not a command for built-in PowerShell 5.1.

Windows · CMD
curl.exe -fsSL --connect-timeout 15 --max-time 120 https://raw.githubusercontent.com/Qyn77/dsh-tui/main/scripts/install.mjs -o "%TEMP%\dsh-tui-install.mjs" && node "%TEMP%\dsh-tui-install.mjs"

Windows CMD — installation only; run the TUI in Windows Terminal + PowerShell 7

curl.exe downloads the script, then Node runs it. Install PowerShell 7 first; launch the TUI in Windows Terminal + PowerShell 7. This is not a command for built-in PowerShell 5.1.

Prerequisites and installation details

Start with Node ≥ 22.19 (including npm), Git and curl, plus access to GitHub/npm. The installer checks your environment and stops with instructions if something is missing; it does not install system prerequisites.

  • Choose ONE command above. PowerShell 7 is required on Windows even if you install from CMD.
  • Builds current source and pins launcher/base/TUI to 0.2.1-rc.5. No global dsh or pnpm is needed. Do not substitute npm latest/next.
  • Checks writable directories, at least 1 GiB of free space and dependency sources; native modules are verified before activation. Builds and backups may need more space.
Why does Windows use curl?

Windows 10 (1803+) and Windows 11 include curl.exe. It downloads the installer; Node executes it. We spell out curl.exe to avoid the curl alias in Windows PowerShell 5.1. Our PowerShell command requires PowerShell 7; the CMD command uses different environment-variable syntax.

Microsoft: curl on Windows ↗

Connect your model

For the official DeepSeek API, edit ~/.dsh/.env locally (Windows: %USERPROFILE%\.dsh\.env), preserving other entries. Replace the placeholder below with your key; never send the real key to a chat or commit it.

.env
DEEPSEEK_API_KEY=YOUR_DEEPSEEK_API_KEY
Credential priority and third-party APIs
  • On macOS/Linux, use chmod 600 ~/.dsh/.env. In Notepad, save as .env, not .env.txt. For a custom --home / DSH_HOME, use that directory instead.
  • Credential priority: managed .credentials.yaml → process environment → project .env → home .env. Update an existing managed key through Desktop credential settings.
  • Third-party APIs also need their own provider URL, model and credential mapping in the TUI profile.

Make yourself at home

Open a new terminal, then launch
dsh-tui

On Windows, fully restart Windows Terminal and open PowerShell 7. After changing credentials, restart the TUI. Select your provider and model with /provider and /model.

Already using Harness Desktop?
  • The same DSH_HOME shares credential storage and home configuration. Desktop-specific model/default-model/plugin settings are not automatically imported into the TUI profile.
  • The installer uses its own pinned Harness runtime. Desktop’s private Node does not replace Node/npm/Git on your terminal PATH. Desktop itself is optional.
  • Storage compatibility was checked for Desktop 0.2.2-rc.1 and TUI runtime 0.2.1-rc.5 on 2026-11-09. No live model request was made: opening the UI does not prove credentials are valid. Automatic desktop configuration import remains planned.

WHEN YOU NEED MORE

The commands you reach for first

The essentials are one slash away. Open the reference when you need a reminder.

Every command and keybinding, in full
/help
Print the slash commands
/model
Show the model; /model opens a picker across every mounted provider
/mcp
Connected MCP servers and their tools; /mcp add connects one
/permission
Pick a sandbox + approval preset
/context
Context window, this session’s token spend, how full it is
/copy
Newest reply to your clipboard over OSC 52 — works through SSH
! <cmd>
Run a shell command; !! also shows it to the model
/exit
Leave the REPL
Read the docs ↗