dsh-ccTUI
Claude Code style TUI for Deepseek-Harness — 🐳 ported from the clawcodex ui-tui and
packaged as a dsh bundle plugin (npm package dsh-cctui).
The full Claude-Code-style look, feel, and interactions — streaming markdown transcript, tool trail
with diff cards, approval and question prompts, plan review, session switcher and resume,
slash commands, model picker, context bar — running in-process against harness services
(ctx.agents, session/event, the approval waterfall, ctx.userQuestions, ctx.commands).
██████╗ ███████╗██╗ ██╗ ██████╗ ██████╗████████╗██╗ ██╗██╗
██╔══██╗██╔════╝██║ ██║ ██╔════╝██╔════╝╚══██╔══╝██║ ██║██║
██║ ██║███████╗███████║ █████╗ ██║ ██║ ██║ ██║ ██║██║
██║ ██║╚════██║██╔══██║ ╚════╝ ██║ ██║ ██║ ██║ ██║██║
██████╔╝███████║██║ ██║ ╚██████╗╚██████╗ ██║ ╚██████╔╝██║
╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝
🐳 Claude Code style TUI for Deepseek-Harness
╭─── dsh-ccTUI v0.3.0 ─────────────────────────────────────────────────────────────────────────╮
│ │
│ Welcome back, you │ ▾ Available Tools │
│ │ harness: bash, create_goal, edit, …+22 │
│ : ' : │ │
│ ___'_______ │ ▸ Available Skills (0) │
│ /' o \--. │ │
│ | ___\ │ ────────────────────────────────────────────── │
│ \____________/ \/ │ 25 tools · 0 skills · /help for commands │
│ \__/ \__/ │ │
│ │ │
│ ──────────── │ │
│ Model deepseek-v4-flash │ │
│ Path ~/workspace/dsh-ccTUI │ │
│ Perms Ask for approval · /permissions │ │
│ Session cctui-56b37bee-41fd-4feb-b270-5988… │ │
│ │
╰──────────────────────────────────────────────────────────────────────────────────────────────╯
Install
Requires Node ≥ 22.19, npm, pnpm, and the dsh CLI (npm install -g @deepseek-ai/dsh).
git clone https://github.com/agentforce314/dsh-ccTUI.git
cd dsh-ccTUI
./install.sh # builds, then: dsh plugin --profile dsh-cctui add "$PWD"
dsh --profile dsh-cctui # launch (or ./bin/dsh-cctui.js)
Model/provider configuration comes from your dsh profile (agent-default-model settings or
an - id: cctui config override in the profile's cordis.patch.yml: provider, model,
cwd, sessionId).
API key
The TUI stores no key; the harness resolves one per request. Write it to the managed store
at $DSH_HOME/.credentials.yaml (default ~/.dsh/.credentials.yaml) — a YAML mapping of
credential reference to value and nothing else:
DEEPSEEK_API_KEY: sk-…
chmod 600 that file and chmod 700 ~/.dsh: dsh-credentials-local refuses to read a
document carrying any group or other permission bit, and fails at boot naming the repair.
The document is watched, so a key stored while the TUI is running takes effect on the next
request — first run is "browse models, store the key, prompt again", no restart in between.
Until one resolves, the route stays registered and /model stays browsable; it is the
request that fails, with MISSING_CREDENTIAL naming every entry point it looked at.
The launching environment beats the store (DEEPSEEK_API_KEY=… dsh --profile dsh-cctui) and
is deliberately read-only from inside; the store in turn beats <cwd>/.env and
~/.dsh/.env. Keep the key itself out of cordis.patch.yml — adapter config carries only
apiKeyEnv, the reference to resolve. One key covers both the conversation and the
web_search tool.
Mode 0600 stops other OS users, not the model: the harness never hands it the document's
path and never loads the value into the environment, but bash and the filesystem tools run
as you and the shipped policy confines writes rather than reads.
Highlights
- Conversation loop: streamed deltas render live; reasoning shows a line or two with the
whole chain of thought behind Ctrl+O; busy verbs and spinners; Esc interrupts (Ctrl+C never
kills the app).
- Tools: Claude-style
⏺ Tool(args) / ⎿ result trail — every call keeps its own row
with the path it opened or the command it ran, over a few lines of what came back and
… +N lines (ctrl+o to expand); a failed call carries the tool's own message and a running
one its own clock; write/edit diffs render as structured diff cards; sandbox-escalation
approvals pop the approval box (1 approve / 2+Enter deny); todo lists pin under the
busy line.
- Subagents: a delegation reads
⏺ Subagent(Review the diff) / ⎿ Done (2 tool uses · 1.2k tokens · 11s), and its children stream into /agents — goal, live tool calls,
tokens, spawn tree.
- Sessions:
/sessions (Ctrl+X) lists live and persisted sessions; /resume <id>
replays a persisted transcript, tool results and all; /new, /title, /rename.
- Commands: every harness
ctx.commands entry (e.g. /plan, /goal) appears in the
completion menu and dispatches through the harness; /model opens the picker backed by
the llm catalog; /effort, /context, /usage, /help, /status.
- Modes: Shift+Tab cycles default → plan → bypassPermissions (mapped onto the harness
plan-mode controller and approval policy).
Configuration
Environment knobs use the DSH_CCTUI_ prefix — e.g. DSH_CCTUI_INLINE=0 (alternate screen
instead of inline scrollback), DSH_CCTUI_THEME=light|dark, DSH_CCTUI_HOME (data dir,
default ~/.dsh-cctui), DSH_CCTUI_FPS=1. CLAUDE_CODE_SCROLL_SPEED is still honored as a
migration fallback for people coming from Claude Code.
Development
npm install
npm run typecheck && npm test # 149 files / ~1900 tests
npm run e2e # PTY e2e against a real dsh boot + scripted LLM
npm run e2e:install # the real `dsh plugin add` install path
Tool rows are the fiddliest surface to eyeball, so they have their own harness:
python3 scripts/tool-gallery.py [tool…] [--expand] drives a real dsh boot through one
harness tool per scenario (via the scripted test/e2e/probe-llm.mjs) and prints the trail it
rendered — the thing to diff against the same call made to Claude Code.
Versioning
Each shipped change increments the patch digit by one; it runs to 99 before rolling over
into the minor digit:
0.2.0 → 0.2.1 → … → 0.2.13 → … → 0.2.99 → 0.3.0 → 0.3.1 → …
Write patch numbers without leading zeros (0.3.1, not 0.3.01 — the latter is not valid
semver and npm rejects it). Bump package.json in the change's own commit, then tag
v<version> on main after it merges.
Architecture and porting details: docs/ARCHITECTURE.md,
docs/PLAN.md, docs/PORTING-NOTES.md. The adapter
boundary (src/harness/ is the only place that may import @deepseek-ai/*) is CI-gated.
Provenance & license
MIT. Substantial portions are ported from the MIT-licensed clawcodex ui-tui (including its
forked Ink renderer) with integration patterns from the MIT-licensed dsh-TUI project — see
NOTICE.md.
