What is this?
An interactive terminal UI plugin for DeepSeek Harness (DSH): a pixel-whale header, live work status line, streaming thinking display, double-Esc time rewind, a context progress bar and a TPS gauge.
An interactive terminal UI plugin for DeepSeek Harness (DSH): a pixel-whale header, live work status line, streaming thinking display, double-Esc time rewind, a context progress bar and a TPS gauge.Is this a separate app, or does it plug into DeepSeek Harness?It's a pure plugin that mounts on top of DeepSeek Harness with zero core changes — installing enables it, and uninstalling leaves no core patches behind.
It's a pure plugin that mounts on top of DeepSeek Harness with zero core changes — installing enables it, and uninstalling leaves no core patches behind.How do I get it running?Prerequisites are Node.js, the deepseek-harness CLI and a registered DEEPSEEK API key; then it's a one-command npm install, with a manual install.sh in the repo root as the alternative.
Prerequisites are Node.js, the deepseek-harness CLI and a registered DEEPSEEK API key; then it's a one-command npm install, with a manual install.sh in the repo root as the alternative.Any install pitfalls I should know about?With pnpm ≥11 the install may fail with ERRPNPMIGNOREDBUILDS — pnpm blocks deps whose install scripts (like @google/genai, protobufjs) aren't actually needed at runtime. /update and dsh-tui update write the pnpm-workspace.yaml fix automatically.
With pnpm ≥11 the install may fail with ERRPNPMIGNOREDBUILDS — pnpm blocks deps whose install scripts (like @google/genai, protobufjs) aren't actually needed at runtime. /update and dsh-tui update write the pnpm-workspace.yaml fix automatically.What can I actually do from inside the TUI?Session tools like /resume (browse, search, pin past sessions), /agentview for background sessions, /new, /compact, /export, /btw, hot model switching, native subagents, session forking, auto-update, a /vim editing mode, mouse selection and a fullscreen draft editor (Ctrl+Shift+E).
Session tools like /resume (browse, search, pin past sessions), /agentview for background sessions, /new, /compact, /export, /btw, hot model switching, native subagents, session forking, auto-update, a /vim editing mode, mouse selection and a fullscreen draft editor (Ctrl+Shift+E).Will image previews work in my terminal?Only if the terminal supports Kitty graphics or Sixel — detection prefers Kitty, then DA1-declared Sixel capability, overridable via DSHTUIIMAGEPROTOCOL. tmux/screen, non-TTY output and accessibility mode fall back to text.
Only if the terminal supports Kitty graphics or Sixel — detection prefers Kitty, then DA1-declared Sixel capability, overridable via DSHTUIIMAGEPROTOCOL. tmux/screen, non-TTY output and accessibility mode fall back to text.What's the pixel whale mascot about?A random one-of-three opening animation plays at startup, and before your first task you can click to spawn hearts and wake the sleeping whale while idle animations (fin waves, tail slaps, sleeping Z's) run. After the first task it freezes to a static frame with zero ongoing cost; there's an off-switch in /settings → whaleIdle. The 22-frame hand-drawn art is ported from dsh-ui-whale by @lhh010.
A random one-of-three opening animation plays at startup, and before your first task you can click to spawn hearts and wake the sleeping whale while idle animations (fin waves, tail slaps, sleeping Z's) run. After the first task it freezes to a static frame with zero ongoing cost; there's an off-switch in /settings → whaleIdle. The 22-frame hand-drawn art is ported from dsh-ui-whale by @lhh010.What does the live status line show?Work status, TPS, cache hit rate, reasoning level, input/output token counts and Git/session info, with several themes available (moon8 is the default). Multi-line command cards can collapse to one line plus a count, and in fullscreen a ~600ms hover reveals the full content of truncated cards or messages.
Work status, TPS, cache hit rate, reasoning level, input/output token counts and Git/session info, with several themes available (moon8 is the default). Multi-line command cards can collapse to one line plus a count, and in fullscreen a ~600ms hover reveals the full content of truncated cards or messages.Can I build my own plugins on top of it?Yes — there's a plugin development guide with admission specs, a dsh-tui-ecosystem community org, a plugin-template repo that gets you a plugin in about 5 minutes, and a reference implementation (dsh-working-activity). Extension seams are tiered by maturity: some are stable candidates, others experimental or bound to upstream Cordis/DSH.
Yes — there's a plugin development guide with admission specs, a dsh-tui-ecosystem community org, a plugin-template repo that gets you a plugin in about 5 minutes, and a reference implementation (dsh-working-activity). Extension seams are tiered by maturity: some are stable candidates, others experimental or bound to upstream Cordis/DSH.What are similar projects?DeepSeek-Reasonix, cocode, seektty, dsh-tianshu-tui, deepseek-harness-for-vscode, operator-memory, ordewell, dsh-crew
DeepSeek-Reasonix, cocode, seektty, dsh-tianshu-tui, deepseek-harness-for-vscode, operator-memory, ordewell, dsh-crewWhich topics is it in?terminal-ui, vscode-extension, dsh-plugin, deepseek-harness, tui, deepseek, coding-agent, plugin, react, claude-code, npm, terminal
terminal-ui, vscode-extension, dsh-plugin, deepseek-harness, tui, deepseek, coding-agent, plugin, react, claude-code, npm, terminal