dsh-pi-tui-shim

pi's real terminal UI as the front door for DeepSeek Harness (dsh).

dsh-pi-tui-shim is a dsh profile bundle that mounts
@earendil-works/pi-coding-agent's
InteractiveMode — the exact TUI pi uses — and bridges it to the dsh agent
runtime. The agent, tools, sessions, and credentials stay DeepSeek Harness;
the look is pi's, and it updates automatically whenever pi updates its TUI.

Status

✅ Working. The bundle mounts pi's real InteractiveMode over the dsh
agent-loop and renders live turns end-to-end: user input, assistant streaming,
tool calls with result cards, multi-turn context, and persisted-session resume
(--resume <session-id>). Verified interactively in a real terminal.

Why not just use @dsh-tui/dsh-tui?

Other dsh TUIs are reimplementations of a terminal UI — same library family
(@earendil-works/pi-tui), different components, different palette, different
rendering. This project instead reuses pi's actual InteractiveMode and theme
as a dependency, so the visual identity is pi's by construction and follows pi
releases without edits here.

Requirements

  • dsh CLI (DeepSeek Harness)
  • Node.js ^22.19 || >=24
  • pnpm (for profile plugin management)

Install

Install from GitHub (not yet published to npm):

dsh plugin --profile tui-pi add github:utensil/dsh-pi-tui-shim
dsh --profile tui-pi

Resume a persisted session:

dsh --profile tui-pi --resume <session-id>

Credentials

The profile reads DEEPSEEK_API_KEY through the dsh credentials service,
exactly like the shipped headless/web profiles — store it once via the
credentials store or environment:

# managed store (~/.dsh/.credentials.yaml, mode 0600)
# or the launching environment:
export DEEPSEEK_API_KEY=sk-...

How it works

dsh (cordis runtime)
  ├── dsh-base            agent-loop · sessions · tools · credentials · models
  └── dsh-pi-tui-shim
        ├── tui-startup   parses --resume, provides the session identity
        └── tui           mounts pi's InteractiveMode (imported), bridged to
                          the dsh agent via an AgentSessionRuntime-shaped shim
  • The TUI shell, theme, and rendering are pi's InteractiveMode — imported,
    never reimplemented.
  • The bridge translates user input → dsh turns and dsh agent events → pi
    session events (assistant messages, tool calls, reasoning).
  • Everything else (tools, sessions, permissions, credentials) is unmodified
    dsh-base.

Development

git clone git@github.com:utensil/dsh-pi-tui-shim.git
cd dsh-pi-tui-shim
dsh plugin --profile tui-pi add file:.
dsh --profile tui-pi            # or --dump-config to inspect composition

TUI changes are verified in a real terminal (tmux + capture-pane), mirroring
the interaction tests in the dsh ecosystem.

License

MIT