tui.md

deepseek tui — Terminal Workbench

deepseek tui starts the ratatui/crossterm full-screen workbench shell. Bare deepseek now routes here automatically when stdin and stdout are both real TTYs; use deepseek chat for the older line-oriented REPL.

Current surfaces:

• Plan / Agent / YOLO mode tabs
• sidebar with mode, selected durable session metadata, and key hints
• transcript backed by durable thread items when available
• transcript, detail, and MCP manager panels hard-wrap long CJK or no-whitespace runs by terminal display width so scrollback stays aligned with rendered content
• transcript, detail, and MCP manager panels strip unsupported terminal control wrappers such as OSC 8 hyperlinks before clipping/wrapping, preserving visible link labels without leaking escape bytes into the rendered buffer
• composer input that appends user turns/items to the active durable thread and starts a background agent response in interactive TUI sessions
• composer # <note> memory capture and /memory local commands for opt-in user memory without starting a model turn
• persistent workspace notes with note / /note, including note add|list|show|edit|remove|clear|path
• workspace anchors with anchor / /anchor, including anchor add|list|remove|path over .dscode/anchors.md
• busy-turn follow-up queue with queue / /queue, including queue list|edit|drop|clear; plain composer input is queued while an assistant message is still running and dispatched when the turn becomes idle
• active thread sharing with share / /share, rendering the durable transcript to standalone HTML and attempting a public GitHub Gist via gh
• active thread Markdown export with export / /export [path], defaulting to chat_export_<timestamp>.md in the selected workspace
• active session JSON snapshots with save / /save [path] and load / /load <path>, importing snapshots into fresh durable runtime ids
• local media attachment insertion with attach / /attach, image / /image, and media / /media, adding validated image/video references to the composer draft
• runtime-backed sub-agent task inspection and queueing with subagents / /subagents, agents / /agents, and agent [0-3] <task> / /agent [0-3] <task>
• persistent RLM process kickoff with rlm [0-3] <file_or_text> / /rlm, plus recursive / /recursive aliases, routed through the active thread as an rlm_process live=true agent instruction
• session relay kickoff with relay [focus] / /relay, batonpass, and 接力, asking the active agent to write .dscode/handoff.md
• hook inspection with hooks / /hooks, including hooks list and hooks events over the configured project/user hook roots
• composer and command palette custom slash commands from project .dscode/commands/*.md or the configured user commands dir
• composer slash-command hints and Tab completion for built-in local slash commands, project .dscode/commands/**/*.md entries, configured user command entries, configured skill names, and DeepSeek-TUI command families such as /compact, /mcp, /jobs, and /restore while typing /...
• remote skill registry sync with /skills sync, caching supported TOML, SKILL.md, GitHub, tar.gz, and zip entries under the configured skills.cache_dir
• feedback picker and links with feedback / /feedback, feedback show, and feedback bug|feature|security
• repository and DeepSeek API link picker with links / /links, links show, plus dashboard / /dashboard and api / /api aliases
• home dashboard with home / /home plus stats / /stats and overview / /overview aliases
• active-thread goal tracking with goal / /goal, including optional token budget display from active-thread usage telemetry; file-backed and HTTP runtime sessions persist the goal as durable thread events so it is restored after TUI restart, resume, or runtime reconnect
• slash-mode switching with mode / /mode and mode agent|plan|yolo|1|2|3
• help index and command topics with help / /help, help <command>, and /?
• settings overview with settings / /settings and DeepSeek-TUI-style config / /config routing for common model/provider/profile/mode/theme settings
• persisted local TUI theme switching with theme / /theme, theme dark|light|grayscale|system, and .dscode/tui/theme.json
• statusline overview with statusline / /statusline
• verbose transcript switching with verbose / /verbose and verbose on|off|show, keeping reasoning compact by default while allowing full live thinking text on demand
• locale output switching with translate / /translate and translate on|off|show, adding a language-output requirement to future local agent turns plus a post-hoc translator for English-heavy final replies
• context inspection with context / /context and ctx / /ctx, showing active-thread context window, compaction strategy, token/cache telemetry, and reasoning replay state
• bundled changelog inspection with change / /change, changes / /changes, and changelog / /changelog
• local runtime system prompt preview with system / /system, including the selected workspace instructions, user memory, and latest selected user message
• latest-message editing with edit / /edit, loading the selected thread's latest user message back into the composer and resubmitting through a rollback fork
• conversation undo/retry with undo / /undo and retry / /retry, forking the selected durable thread before the latest user request while preserving the original thread
• durable compaction handoff inspection and archive search with cycles / /cycles, cycle <n> / /cycle <n>, and recall <query> / /recall <query>
• deterministic local review with review <target> / /review <target>
• named config profile switching with profile [name|list|clear] / /profile [name|list|clear]
• workspace trust management with trust [on|off|add <path>|remove <path>|list] / /trust [on|off|add <path>|remove <path>|list]
• local API key state cleanup with logout / /logout
• workspace diff inspection with diff / /diff, showing staged, unstaged, and untracked files, hunk previews, diff stats, and review/rollback next-step prompts for the selected session workspace
• slash quit aliases with exit / /exit, quit / /quit, and q / /q
• conversation reset with clear / /clear, creating a fresh empty active thread in the selected durable session without deleting older thread history
• composer draft stash: Ctrl+S parks the current draft, and stash list|pop|clear / /stash list|pop|clear manage parked drafts
• session rename from the command palette or slash-style composer command with rename <title> / /rename <title>
• project instruction initialization with init / /init, creating AGENTS.md in the selected session workspace
• network policy controls with network list|allow|deny|remove|default, editing the selected session workspace .dscode/config.toml
• LSP-style diagnostics controls with lsp / /lsp and lsp on|off|status, editing diagnostics.post_edit in the selected workspace project config
• runtime status inspection with status / /status, summarizing selected session, active thread, transcript items, tasks, automations, pending approvals/user input, token/cache telemetry, context policy, and estimated cost in the detail panel
• token and cost inspection with tokens / /tokens and cost / /cost, matching DeepSeek-TUI's runtime usage and approximate spend commands
• cache telemetry inspection with cache [count] / /cache [count] plus read-only cache inspect prompt-layer diagnostics and cache warmup explanations over durable usage records
• model picker, inspection, and switching with model / /model, model show, model preset <auto|flash|pro>, model <name> / /model <name>, and offline models / /models; known DeepSeek V4 aliases are normalized for the active provider, so official DeepSeek endpoints receive bare deepseek-v4-* ids while compatible backends keep provider-specific ids. /pro arms DeepSeek V4 Pro for the next submitted user turn, /pro off cancels the one-turn override, and /pro show inspects it without permanently changing the workspace config. Composer slash completions for /model <name> and command-palette completions for model <name> use the selected workspace's current provider so suggested model ids match the active backend.
• provider preset picker, inspection, and switching with provider / /provider, provider show, provider list, and provider <name> [model]; legacy DeepSeek CN aliases such as deepseek-cn, deepseek_china, deepseekcn, and deepseek-china map to the canonical DeepSeek preset. The picker opens on the selected workspace's current provider/model when it can infer them from .dscode/config.toml, and reselecting the active provider preserves a custom current model instead of silently resetting to the preset default.
• skill registry inspection and local user-skill management with skills [prefix] / /skills [prefix], /skills --remote, /skills sync, skill <name> / /skill <name>, /skill new, /skill install <registry-name|url>, /skill update <name>, /skill trust <name>, and /skill uninstall <name> over DeepSeekCode's configured TOML skills and remote registry metadata
• composer and command-palette editing preserve terminal modifier keys, including Ctrl-based line, word, and cursor controls
• task panel with active thread status, runtime item count, item state/type progress counts, latest item summary, first-run setup guidance, live agent timeline, recent runtime tasks, active-thread automations, usage total, cache-hit rate, cache chart, estimated cost, input/output cost split, cost chart, and 1M-context policy when usage records exist
• command palette with local UI commands and active-thread runtime actions
• command palette history with Up / Down recall while the palette is active
• command palette prefix completion with Tab for built-in workbench commands
• session picker populated from .dscode/runtime/sessions, linked threads, and item timelines
• thread navigator populated from the selected session's durable runtime threads
• session picker and thread navigator filters through session filter <query> / /sessions filter <query> and thread filter <query> for large durable runtime lists
• session housekeeping with /sessions prune <days> for local file-backed runtime stores
• mouse capture for workbench navigation: click Plan/Agent/YOLO tabs to switch modes, click visible session/thread picker rows to select them, scroll the wheel to reuse the active scroll/navigation target, and click the transcript panel to focus the composer
• legacy unmarked Windows ConHost sessions keep keyboard navigation but skip mouse capture by default; modern Windows terminal hosts keep mouse support
• live runtime refresh for file-backed sessions, threads, and items while the TUI is open; assistant deltas from TUI-started runs update a running durable assistant item before final completion and are also pushed through an in-process live channel drained before each draw
• external runtime writes are picked up by a local runtime watcher that sends full snapshot live events into the same draw loop, so task/approval/item changes from other DeepSeekCode processes do not wait for the slower refresh
• deepseek tui --runtime-url http://HOST:PORT connects the workbench to a running HTTP runtime, builds the initial UI from /v1/sessions and linked thread detail endpoints, writes composer/approval/cancel/task/automation/ compaction/goal actions back through HTTP, and subscribes to the aggregate /v1/events/stream?follow=1 runtime stream so foreground refresh covers known and newly created threads
• approval modal backed by durable permission_request runtime events appended directly or through POST /v1/threads/{id}/events
• approval accept/deny records durable permission_response events and can unblock permissioned tools for agent runs started from the TUI composer
• approval modal text explains once/session/deny scope, the exact permission key, the cached group key, and the likely impact class for shell, write, network, and MCP requests
• approval audit commands show pending requests, cached session approvals, request/decision/revoke history, and can revoke cached session approval groups with approval revoke session <id|last>
• user-input modal backed by durable user_input_request runtime events; number keys choose predefined options, and o opens a short free-form Other answer editor that writes the same structured response event
• background TUI agent runs append assistant messages, tool result items, usage records, and completed/failed task records back into the active thread
• active-thread runtime task records are loaded from .dscode/runtime/tasks and rendered in the task panel with status counts, short task ids, updated timestamps, clipped summaries, and a > marker for the selected task
• task detail views include state-specific next-step hints for pending, running, paused, completed, failed, and cancelled task records
• task panel rows support cross-surface multi-select with Ctrl+click, drag-select, task select all, and task select clear; when tasks are selected, task pause, task resume, and task cancel operate on compatible selected tasks, and explicit task bulk pause|resume|cancel aliases are available
• active-thread runtime items are summarized in the task panel with state/type counts and the latest item, so streamed agent progress and tool activity are visible while a background run is active
• first-run setup gaps are summarized in the task panel with /setup wizard and direct jump commands for provider, model, API key, trust, and network policy setup
• running agent turns show a compact task-panel timeline with current step, recent tool, elapsed time, pending approvals, queued follow-up messages, and next-action hints
• persisted reasoning items can be inspected from the command palette with reasoning, reasoning latest, reasoning show <selector>, and reasoning search <query>; the same panel exposes reasoning replay <N> and reasoning pin <selector> for controlling which persisted reasoning items local TUI-started agent runs replay into the next request. The local file-backed TUI stores the replay limit and pinned turn ids in .dscode/tui/reasoning-replay.json.
• task <summary> / task create <summary> and /task add <prompt> create a pending active-thread agent task for the durable task daemon or external runners; /task list and /task show <id> inspect active-thread tasks in the detail panel
• task next, task prev, and task select <id> move the selected task in the active thread's task panel; left-clicking a visible task row also selects it
• task pause [id], task resume [id], and task cancel [id] control durable runtime tasks from the active thread; omitting id uses the selected task when its status is compatible, then falls back to the first matching pending/paused/cancellable task in the current task panel
• active-thread automation records are loaded from .dscode/runtime/automations; automation trigger [id] [prompt override] creates a pending automation task through the runtime store
• compact / /compact / compact <tail> / /compact <tail> appends a durable active-thread compaction summary and thread_compacted audit event through the runtime store
• c / cancel records a durable cancel_requested event for the active running assistant turn; TUI-started agent runs stop at cancellation checkpoints and mark the assistant item/task cancelled
• TUI-started agent runs create a pre-run rollback snapshot in git worktrees and bind it to the durable assistant turn for restore show / restore revert-turn
• local file-backed TUI sessions expose rollback commands in the command palette: restore snapshot [label], restore list [limit], restore show <snapshot-id|turn-id|last>, restore hunks <snapshot-id|turn-id|last>, restore hunk <snapshot-id|turn-id|last> [index], and revert turn <snapshot-id|turn-id|last> [--apply]; last resolves to the active thread's latest durable turn id, and list/show/revert results render a scrollable right-side rollback detail panel with patch or restore-plan context. Apply restores open a confirmation modal before mutating files
• diagnostics [--changed|paths...] runs through the local diagnostics runner in file-backed TUI sessions and through POST /v1/diagnostics in HTTP runtime TUI sessions, so remote runtime mode can reuse the runtime process' warmed LSP diagnostics broker
• local file-backed TUI sessions expose a safe background shell command path through shell <command> / shell run <command> and ! <command>. Commands use the same allowlist as exec_shell by default; unallowlisted foreground commands open an explicit approval modal and only run once after approval. Approved commands start as process-local background jobs, and can be listed with shell list, inspected with shell show <id> / shell attach <id> [cursor|tail] / shell poll <id> / shell wait <id> [ms], fed with shell stdin <id> <input> / shell close-stdin <id>, resized with shell resize <id> <rows> <cols>, stopped with shell cancel <id|all>, or paired with workspace-local supervisor protocol health through shell supervisor; /jobs-style jobs list|show|attach|poll|wait|stdin|close-stdin|resize|cancel|supervisor aliases are also accepted
• local file-backed TUI sessions expose user-memory controls when memory.enabled = true or DSCODE_MEMORY=on: a composer line beginning with a single # appends a durable memory note without submitting a user turn, and /memory show|path|clear|edit|help plus command-palette memory show|path|clear|edit|help inspect or manage the configured memory.memory_path
• local file-backed TUI sessions expose an MCP manager screen through mcp / mcp manager; mcp manager tools|prompts|resources|resource-templates [server] renders discovery summaries in that full-width screen. The manager includes overview/tools/prompts/resources/templates/health tabs and supports mcp manager tab <tab> plus Tab / Shift+Tab keyboard cycling, r reload, n / p server selection, selected-server e enable, d disable, x remove, t tools, Space multi-select toggle, A select visible, U clear selection, E / D bulk enable/disable selected servers, and mcp manager filter <query> for line filtering. The full-width manager also supports mouse tab clicks, server-row selection, Ctrl+click server-row multi-select toggles, drag-select across visible server rows, and action-strip clicks for enable, disable, remove, tools, and reload. When server rows are multi-selected, enable/disable action-strip clicks apply to the selection. They also expose project-level MCP manager commands in the command palette: mcp init [--force], mcp add stdio <name> <command> [args...], mcp add http <name> <url>, mcp add sse <name> <url>, mcp enable|disable|remove <name>, and mcp validate; they also expose mcp tools [server], mcp prompts [server], mcp resources [server], and mcp resource-templates [server] detail views in the scrollable right-side panel; Esc or mcp close returns that panel to the task view. The same add/enable/disable/remove commands can target user config with mcp user ...; unscoped commands keep using project config. HTTP MCP discovery/call commands preserve Mcp-Session-Id values from GET preflight or POST responses when talking to Streamable HTTP servers.

Useful commands:

deepseek
deepseek tui
deepseek tui --demo
deepseek tui --demo --once
deepseek tui --entrypoint-smoke --smoke-bin "$(command -v deepseek)"
deepseek serve --http --addr 127.0.0.1:13000
deepseek tui --runtime-url http://127.0.0.1:13000

--once renders a deterministic ratatui test-backend snapshot to stdout. Use it for CI and release smoke checks where a real TTY is not available. --entrypoint-smoke starts bare deepseek under a real PTY through script, verifies alternate-screen TUI rendering, sends q, and emits deepseek.tui.entrypoint_smoke.v1 JSON evidence.

Key bindings:

Key	Behaviour
Tab	Complete command-palette input while the palette is active; complete built-in, project, user, or skill /... commands while the composer is focused; otherwise cycle Plan / Agent / YOLO mode
Tab, Shift+Tab	Cycle MCP manager tabs while the full-width MCP manager is visible
n, p, e, d, x, t, r, Space, A, U, E, D	Select next/previous MCP server, enable, disable, remove, show tools, reload, toggle/select/clear multi-select, or bulk enable/disable while the full-width MCP manager is visible
p, a, y	Switch directly to Plan, Agent, or YOLO
i	Focus composer
Enter	Submit composer text while focused
Left, Right	Move the focused composer or command palette cursor
Backspace, Delete	Edit the focused composer or command palette text
Ctrl+A, Ctrl+E	Move the focused composer or command palette cursor to start/end
Ctrl+U, Ctrl+K, Ctrl+W	Clear line, delete to end of line, or delete previous word in the focused composer or command palette
Ctrl+S	Stash the focused composer draft and clear the composer
Ctrl+Left, Ctrl+Right	Move by word in the focused composer or command palette
Ctrl+C	Quit the TUI
Up, Down, PageUp, PageDown	Recall command-palette history while the palette is active; move through session/thread pickers while visible; scroll the MCP manager/detail panel while visible; PageUp / PageDown also scroll transcript history while the composer is focused, and Windows composer Up / Down defaults to transcript scrolling for wheel-as-arrow input; otherwise scroll transcript history
Home, End	Move the focused input cursor; jump session/thread pickers, MCP manager/detail, or transcript scrollback to first/last positions
:	Open command palette
s	Open session picker
t	Open thread navigator
!	Open approval modal
1, 2, 3, o	Answer an active user-input modal with a predefined option or an Other answer
c	Cancel the active running assistant turn
q, Esc	Quit, close the active modal, or close MCP manager/detail while it is visible

Mouse controls:

Mouse	Behaviour
Left click Plan / Agent / YOLO tab	Switch mode
Left click visible session picker row	Select that session and close the picker
Left click visible thread navigator row	Select that thread and close the navigator
Left click MCP manager tab	Switch full-width MCP manager tab
Left click MCP manager server row	Select that server for action-strip commands
Ctrl+left click MCP manager server row	Toggle that server in the multi-select set
Drag over MCP manager server rows	Select the visible server-row range for bulk actions
Left click MCP manager action strip	Run the clicked enable, disable, remove, tools, or reload action
Left click visible task panel task row	Select that active-thread runtime task for default task actions
Ctrl+left click visible task panel task row	Toggle that task in the multi-select set
Drag over visible task panel task rows	Select the visible task-row range for bulk actions
Left click transcript panel	Focus composer input
Scroll wheel	Reuse the active PageUp/PageDown target: picker navigation, MCP/detail scroll, or transcript scrollback

Command palette commands currently implemented:

Command	Behaviour
help, /help, /?	Show the TUI help index in the right-side detail panel
help <command>, /help <command>	Show command-specific usage, aliases, and description
settings, /settings, config, /config	Show mode, config file locations, and focused configuration command entry points
setup, onboarding, doctor, /setup, /onboarding, /doctor	Show a read-only onboarding checklist with selected workspace config, model, API key env, live-model readiness, and next commands
setup wizard, /setup wizard	Open the first-run stepper with per-step done/todo/review state for provider, model, auth, trust, network, theme, and language setup
`setup provider	model
config tui, config native, config web, /config tui, /config native, /config web	Show the requested config surface and focused DeepSeekCode config commands
config model [pick|show|list|preset <auto|flash|pro>|<name>], /config model [pick|show|list|preset <auto|flash|pro>|<name>]	Route to selected workspace model picker, inspection, catalog, preset, or update commands
config provider [pick|show|list|<name> [model]], /config provider [pick|show|list|<name> [model]]	Route to provider preset picker, inspection, or updates
config profile [list|clear|<name>], /config profile [list|clear|<name>]	Route to active project profile inspection or switching
config mode [agent|plan|yolo], /config mode [agent|plan|yolo]	Show or switch the current TUI mode
config theme [dark|light|grayscale|system], /config theme [dark|light|grayscale|system]	Show or switch the current TUI theme, persisted in .dscode/tui/theme.json
config verbose [on|off|toggle|show], /config verbose [on|off|toggle|show]	Show or toggle verbose transcript rendering
config translate [on|off|toggle|show], /config translate [on|off|toggle|show]	Show or toggle translated natural-language output
theme, /theme	Cycle the local TUI theme, persist it, and show the theme detail panel
theme show, /theme show	Show current theme and available theme commands
`theme dark	light
statusline, /statusline	Show command bar items, shortcuts, and related status/config commands
verbose, /verbose	Toggle whether live reasoning text is rendered in full in the transcript
`verbose on	off
translate, /translate	Toggle locale-targeted model output for future local agent turns
`translate on	off
context, /context, ctx, /ctx	Show active-thread context window, token/cache, item, and reasoning replay state
goal, /goal	Show the current active-thread goal and token budget progress
goal <objective> [budget: N], /goal <objective> [budget: N]	Set or replace the current active-thread goal
goal clear, /goal clear	Clear the current active-thread goal
exit, /exit, quit, /quit, q, /q	Quit the TUI workbench
mode, /mode	Show current mode and mode-switching commands in the right-side detail panel
`mode agent	plan
mode plan, plan	Switch to Plan mode
mode agent, agent	Switch to Agent mode
mode yolo, yolo	Switch to YOLO mode
sessions, session, resume, /sessions, /session, /resume	Open the session picker
session filter <query>, sessions filter <query>, /sessions filter <query>, session filter	Filter or clear visible sessions in the session picker
sessions prune <days>, /sessions prune <days>	Prune local durable sessions older than the requested age
threads, thread	Open the thread navigator
thread filter <query>, thread filter	Filter or clear visible threads in the thread navigator
thread next, thread prev	Move between durable threads in the selected session
thread <id>	Jump to a durable thread by id, switching sessions if needed
/name [args]	Expand a custom markdown slash command from .dscode/commands/name.md or the configured user commands dir, then submit it to the active thread
init, /init	Create project AGENTS.md instructions in the selected session workspace
rename <title>, /rename <title>	Rename the selected durable session and persist the new title
diff, /diff	Show staged, unstaged, and untracked files with hunk previews, diff stats, and review/rollback next-step prompts
diff help, /diff help	Show diff command behavior and the selected workspace
clear, /clear	Start a fresh active thread in the selected durable session without deleting older history
clear help, /clear help	Show clear/reset behavior and the current session/thread target
undo, /undo	Fork the selected durable thread before the latest user request and switch to that branch
undo help, /undo help	Show non-destructive undo behavior
retry, /retry	Fork before the latest user request, switch to that branch, and resubmit the request
retry help, /retry help	Show retry behavior
cycles, /cycles	List durable compaction handoffs for the selected thread
cycle <n>, /cycle <n>	Show one durable compaction handoff in full
recall <query>, /recall <query>	Search durable runtime archives with recall_archive
review <target>, /review <target>	Run deterministic local review for a file, diff, or supported target
`profile [name	list
`trust [on	off
logout, /logout	Clear selected workspace API key env values from the current TUI process and .env
stash, stash list, /stash list	List parked composer drafts in the right-side detail panel
stash pop, /stash pop	Restore the most recently stashed composer draft
stash clear, /stash clear	Clear all parked composer drafts
tasks, task, /tasks, /task list	Show active-thread tasks
task <summary>, task create <summary>	Create a pending active-thread runtime task
/task add <prompt>	Create a pending active-thread runtime task
/task show <id>	Show active-thread runtime task details
task next, task prev	Move the selected active-thread runtime task
task select <id>	Select an active-thread runtime task by id
task select all, task select clear	Select visible task-panel rows for bulk actions, or clear selected tasks
task pause, task pause <id>	Pause a pending active-thread runtime task
task resume, task resume <id>	Resume a paused active-thread runtime task
task cancel, task cancel <id>, /task cancel <id>	Cancel a pending, paused, or running active-thread runtime task
task bulk pause, task bulk resume, task bulk cancel	Apply the default task action to compatible selected task-panel rows
subagents, /subagents, agents, /agents	List runtime-backed subagent and subagent_input tasks for the active thread
agent [0-3] <task>, /agent [0-3] <task>	Queue a pending active-thread subagent runtime task; omitted depth defaults to 1
subagents help, /agents help, agent help, /agent help	Show sub-agent command behavior and the current thread target
rlm [0-3] <file_or_text>, /rlm [0-3] <file_or_text>	Ask the active agent to open a persistent rlm_process live=true session; omitted depth defaults to 1
recursive [0-3] <file_or_text>, /recursive [0-3] <file_or_text>	Alias for rlm / /rlm
rlm help, /rlm help	Show RLM command behavior and active thread/workspace target
relay [focus], /relay [focus]	Ask the active agent to write a compact session relay to .dscode/handoff.md
batonpass [focus], /batonpass [focus], 接力 [focus], /接力 [focus]	Aliases for relay / /relay
relay help, /batonpass help	Show relay command behavior and active thread/workspace target
shell <command>, shell run <command>, ! <command>	Start an allowlisted local background shell job, or request foreground approval for an unallowlisted command
shell list, jobs list, /jobs list	List known local background shell jobs
shell show <id>, jobs show <id>, /jobs show <id>	Show a shell job snapshot with accumulated output
`shell attach [cursor	tail], jobs attach [cursor
shell poll <id>, jobs poll <id>, /jobs poll <id>	Poll one local background shell job without waiting
shell wait <id> [ms], jobs wait <id> [ms], /jobs wait <id> [ms]	Wait briefly for one local background shell job and show output deltas
shell stdin <id> <input>, jobs stdin <id> <input>, /jobs stdin <id> <input>	Send stdin to a running local background shell job
shell close-stdin <id>, jobs close-stdin <id>, /jobs close-stdin <id>	Close stdin for a running local background shell job
shell resize <id> <rows> <cols>, jobs resize <id> <rows> <cols>, /jobs resize <id> <rows> <cols>	Resize a TTY-backed shell job with best-effort control
`shell cancel <id	all>, jobs cancel <id
shell supervisor, jobs supervisor, /jobs supervisor	Show workspace-local shell supervisor manifest, socket, and protocol health
memory, memory show	Show configured user memory in the right-side detail panel
memory path	Show the configured user memory path and enabled/disabled state
memory clear	Empty the configured user memory file when memory is enabled
memory edit	Print the editor command for the configured user memory file
memory help	Show local memory command help
note <text>, /note <text>, note add <text>	Append a persistent workspace note to memory.notes_path
note list, note show <n>	List notes or show one note in the right-side detail panel
note edit <n> <text>, note remove <n>, note clear, note path	Replace, remove, clear, or locate persistent workspace notes
anchor <text>, /anchor <text>, anchor add <text>	Pin a durable workspace fact in .dscode/anchors.md
anchor list, anchor remove <n>, anchor path	List, remove, or locate workspace anchors
queue, /queue, queue list, /queue list	List follow-up messages queued while the active assistant turn is busy
queue edit <n>, /queue edit <n>	Move a queued follow-up into the composer for editing; Enter requeues or sends it
queue drop <n>, queue clear	Remove one queued follow-up or clear the whole queue
share, /share	Export the active durable thread transcript as HTML and try to upload it with gh gist create --public
share help, /share help	Show share export requirements and current-thread export metadata
export, /export, export <path>, /export <path>	Write the active durable thread transcript to Markdown; relative paths resolve under the selected workspace
export help, /export help	Show export path rules and current-thread export metadata
save, /save, save <path>, /save <path>	Write the active durable session/thread to a JSON snapshot; relative paths resolve under the selected workspace
save help, /save help	Show snapshot save path rules and current session/thread metadata
load <path>, /load <path>	Import a DeepSeekCode TUI session snapshot into a new durable session/thread with fresh runtime ids
load help, /load help	Show snapshot import behavior and path rules
attach <path>, /attach <path>, image <path>, /image <path>, media <path>, /media <path>	Validate a local image/video path and insert an editable attachment reference into the composer
attach help, /attach help	Show attachment aliases, supported media extensions, and selected workspace context
hooks, /hooks, hooks list, /hooks list	Show hook enabled state, timeout, project/user roots, event directories, and executable scripts
hooks events, /hooks events, hook events, /hook events	Show supported hook event directory names
network, network list, /network list	Show network.default, network.allow, and network.deny in the right-side detail panel
network allow <host>, /network allow <host>	Allow a host in the selected workspace project config
network deny <host>, /network deny <host>	Deny a host in the selected workspace project config
network remove <host>, /network remove <host>	Remove a host from allow and deny lists
network default <allow|deny|prompt>	Set the default host policy
lsp, /lsp, lsp status, /lsp status	Show selected workspace diagnostics.post_edit state in the right-side detail panel
lsp on, /lsp on	Enable post-edit diagnostics for successful file edits in the selected workspace project config
lsp off, /lsp off	Disable post-edit diagnostics for successful file edits in the selected workspace project config
status, /status	Show selected session, active thread, task/input, usage, cache, context, and cost status in the right-side detail panel
tokens, /tokens	Show active-thread context, last input/output tokens, cache hit/miss, cumulative token usage, and approximate cost
translate, /translate, translation, /translation, transale, /transale	Toggle future local agent turns to answer natural-language prose in the detected UI locale, with a post-hoc fallback translator for English-heavy final replies while preserving code, paths, URLs, and identifiers
cost, /cost	Show active-thread approximate total, input, and output cost with telemetry caveats
cache, /cache, cache <count>	Show active-thread durable cache hit/miss summary, hit rate, cache chart, context, and approximate cost
cache inspect, cache warmup	Inspect durable prompt-layer diagnostics when recorded, or explain why no TUI-issued warmup request is sent
change, /change, changes, /changes, changelog, /changelog	Show the latest bundled DeepSeekCode changelog entry in the right-side detail panel
system, /system	Show the selected workspace local runtime system prompt preview in the right-side detail panel
edit, /edit	Load the selected thread's latest user message back into the composer for revision
undo, /undo	Fork before the latest user request and make the fork active
retry, /retry	Fork before the latest user request and resubmit it
cycles, /cycles, cycle <n>, /cycle <n>, recall <query>, /recall <query>	Inspect durable compaction handoffs or search archived runtime context
review <target>, /review <target>	Run deterministic local review and render JSON output in the right-side detail panel
model, /model	Open the model picker for the selected workspace
model show, /model show	Show selected workspace model config in the right-side detail panel
model <name>, /model <name>	Update selected workspace model.model; aliases include auto, flash, pro, chat, coder, and reasoner, and DeepSeek V4 aliases are normalized for the active provider
models, /models, model list	Show the offline DeepSeekCode model catalog and current project model
provider, /provider	Open the provider/model picker for the selected workspace
provider show, /provider show	Show selected workspace provider preset inferred from model.base_url
provider list	Show supported provider presets: DeepSeek, NVIDIA NIM, OpenAI-compatible, AtlasCloud, OpenRouter, Novita, Fireworks, SGLang, vLLM, and Ollama
provider <name> [model], /provider <name> [model]	Update selected workspace model.base_url, model.api_key_env, and model.model with provider defaults or an optional model override; deepseek-cn, deepseek_china, deepseekcn, and deepseek-china are accepted as DeepSeek aliases
profile, /profile	Show selected workspace active config profile and configured profile entries
profile list, /profile list	List configured profiles from profiles.<name>.* or [profiles.name] config sections
profile <name>, /profile <name>	Persist workspace.active_profile so future local TUI turns reload that profile
profile clear, /profile clear	Clear the persisted active config profile
trust, /trust, trust list	Show selected workspace trust mode and trusted external paths
trust on, /trust on	Enable persisted all-path trust mode for the selected workspace
trust off, /trust off	Disable persisted all-path trust mode for the selected workspace
trust add <path>, /trust add <path>	Add an existing trusted external path scoped to the selected workspace
trust remove <path>, /trust remove <path>	Remove a trusted external path scoped to the selected workspace
logout, /logout	Remove selected workspace model.api_key_env / vision.api_key_env values from the current TUI process and matching .env assignments
translate, /translate, translation, /translation, transale, /transale	Toggle the session-local language-output requirement for future local agent turns
skills, /skills, skills <prefix>	List configured TOML skills from repo and user skill directories
skills --remote, /skills --remote	Fetch the configured community skill registry and list remote skill names, descriptions, and sources
skills sync, /skills sync	Download supported TOML, SKILL.md, GitHub, tar.gz, and zip registry entries into the configured skill cache directory
skill <name>, /skill <name>, /<skill-name>	Show one configured TOML skill's description, triggers, tools, references, policy, and system append; direct /<skill-name> is tried after custom slash commands
skill new, /skill new	Show the bundled skill-creator skill for drafting a new DeepSeekCode TOML skill
skill install <registry-name|url>, /skill install <registry-name|url>	Install a DeepSeekCode skill from a direct TOML URL, SKILL.md URL, GitHub repo, tar.gz/zip archive, or registry entry into the configured user skills directory
skill update <name>, /skill update <name>	Refetch and replace a user skill installed by /skill install
skill trust <name>, /skill trust <name>	Write a .trusted marker beside a configured user skill TOML file
skill uninstall <name>, /skill uninstall <name>	Remove a configured user skill TOML file and its .trusted marker; bundled repo skills are protected
feedback, /feedback	Open the feedback target picker
feedback show, /feedback show	Show DeepSeekCode feedback targets in the right-side detail panel
`feedback bug	feature
links, /links	Open the link target picker
links show, /links show	Show DeepSeekCode repository/docs links and DeepSeek platform/API docs in the right-side detail panel
`links repo	issues
dashboard, /dashboard, api, /api	Show DeepSeek platform or API docs link detail directly
home, /home, stats, /stats, overview, /overview	Show a compact runtime dashboard with session/thread, task, usage, pending input, and quick-action links
automations, automation	Show active-thread automation count in the status bar
automation trigger, automation run	Trigger the first active automation in the current thread
automation trigger <id> [prompt]	Trigger one current-thread automation with an optional prompt override
compact, /compact, compact <tail>, /compact <tail>	Compact the active durable thread, keeping the latest N turns
thread compact, thread compact <tail>	Alias for active thread compaction
reasoning, reasoning list	Show active-thread reasoning items in the right-side detail panel
reasoning latest, reasoning show <latest|index|item-id|turn-id>	Show full reasoning item content
reasoning search <query>	Show matching reasoning items with highlighted excerpts
reasoning replay <0..20>	Set how many persisted reasoning entries local TUI agent runs replay
reasoning pin <latest|index|item-id|turn-id>	Keep one reasoning turn in local replay beyond the latest-N window
reasoning pins, reasoning unpin <selector|all>	Inspect or clear local reasoning replay pins
mcp, /mcp, mcp manager, /mcp manager, mcp open	Open the full-width MCP manager screen with merged inventory, config sources, and common actions
`mcp manager tab overview	tools
mcp manager filter <query>, mcp manager filter	Filter or clear visible lines in the full-width MCP manager screen
`mcp manager tools	prompts
mcp list, /mcp list, mcp status, /mcp status, mcp reload, /mcp reload	Summarize merged MCP config inventory in the status bar
mcp tools [server]	List configured MCP server tools in the scrollable right-side panel
mcp prompts [server]	List configured MCP server prompts in the scrollable right-side panel
mcp resources [server]	List configured MCP server resources in the scrollable right-side panel
mcp resource-templates [server], mcp templates [server]	List MCP resource URI templates in the scrollable right-side panel
mcp close, mcp clear	Close the MCP manager/detail panel and restore the main workbench
mcp init, mcp init --force	Create or replace project .dscode/mcp.json
mcp add stdio <name> <command> [args...]	Add a project-level stdio MCP server
mcp add http <name> <url>	Add a project-level HTTP MCP server
mcp add sse <name> <url>	Add a project-level SSE MCP server
mcp enable <name>, mcp disable <name>	Enable or disable a project MCP server
mcp remove <name>	Remove a project MCP server
`mcp user add stdio	http
`mcp user enable	disable
mcp validate	Validate enabled MCP servers and show tools/prompts/resources/templates health in the scrollable right-side panel
diagnostics, diagnostics <paths...>	Run local workspace or path-scoped diagnostics and summarize the result in the status bar
diagnostics --changed, diag changed	Run diagnostics against git changed files
restore snapshot [label], /restore snapshot [label]	Create a local rollback snapshot from the current git worktree
restore list [limit], /restore list [limit]	Show recent local rollback snapshots in the right-side detail panel
`restore show <id	last>, /restore show <id
`restore hunks <id	last>, /restore hunks <id
`restore hunk <id	last> [index], /restore hunk <id
`revert turn <id	last> [--apply]`
approval, /approval	Open the approval modal
approval list, /approval list	Show pending approvals and cached session approvals for the active thread
approval history, /approval history	Show durable approval request, decision, and revoke events for the active thread
`approval revoke session [id	last], /approval revoke session [id
cancel, stop	Cancel the active running assistant turn

Current boundaries are explicit: this is a true TUI shell with a first agent-connected composer path, not the complete workbench yet. Agent responses run in the background and stream into a running durable assistant item; for TUI-started runs those item updates also repaint through the live channel at the TUI draw cadence instead of waiting for the 1s durable refresh. Cancellation now reaches cancel-aware model/tool paths, and run_shell kills its process group when the durable cancel event is seen. External runtime writers are surfaced by the local watcher for file-backed TUI sessions, and HTTP-runtime TUI sessions use the aggregate HTTP SSE stream for cross-thread push, including newly created threads. Runtime task progress now supports visible selection plus default selected-task pause/resume/cancel actions. Durable approval responses unblock permission gates for TUI-started agent runs and background runtime runner tasks. Command palette actions cover local UI commands plus the first runtime mutations for approval, cancellation, message submit, and active-thread compaction/automation triggering. Session and thread pickers can now keep command-palette filters while navigating large durable lists, and mouse capture covers first-line mode, picker, scroll, and composer-focus actions. The MCP manager now has a full-width inventory/config screen and can render tools/prompts/resources/templates discovery in that screen; Tab and Shift+Tab cycle manager tabs, while r refreshes the MCP inventory. The manager also keeps a selected-server action strip so n/p can move selection and e/d/x/t can enable, disable, open a remove confirmation modal, or inspect tools for that server. The shorter discovery commands still use the scrollable right-side detail panel. Project instruction init, session rename, rollback, memory, network policy, composer stash, custom slash commands, and MCP manager commands are local-only because they operate on the client's runtime/session files, git worktree, project/user MCP config, configured MCP transports, .dscode/tui/theme.json, .dscode/tui/composer-stash.json, custom command markdown files, and user memory file; HTTP-runtime TUI sessions report that those commands require local file-backed TUI. General external command execution is currently limited to the allowlisted local background shell path.