dsh-vsc

🖥️ Usage

Chat panel

The chat panel is a Copilot-style conversation: streaming assistant output, tool-call cards, collapsible reasoning, context meter, and per-turn token stats. Pending approvals and questions take over the composer so you can respond inline. The session rail on the right shows your history — create, fork, rename, and switch models per session.

Editor integration

Select code and hit dsh: Ask dsh About Selection (Ctrl+Alt+Shift+D) to send it with file context, or use the Explain / Fix / Generate Tests / Review code actions from the editor context menu or lightbulb. When the agent edits files, Copilot-style file-change rows appear in the chat with +added −deleted counts — click one to open the whole-file diff; read calls show a subdued row that opens the file directly.

API key

The DeepSeek API key is stored through the dsh server's credential mechanism (default ~/.dsh/.credentials.yaml, 0600 permissions), matching the Models page of the dsh Web UI. When no key is configured you are prompted once after connecting; you can set or clear it any time with dsh: Set API Key / dsh: Clear API Key. Click the "dsh connected" status bar item to open a menu with settings entries.

If the shell that starts dsh already sets DEEPSEEK_API_KEY, it is treated as a read-only source and the extension's writes are rejected — unset that variable in the shell that starts dsh before saving through the extension.

Keybindings

Action	Windows / Linux	macOS
Open dsh Chat	Ctrl+Alt+D	Cmd+Alt+D
Ask dsh About Selection	Ctrl+Alt+Shift+D	Cmd+Alt+Shift+D

⚙️ Configuration

All settings live under the dsh.* namespace in settings.json (command dsh: Open dsh Settings):

Setting	Default	Description
dsh.cliPath	""	Absolute path to the dsh executable; empty searches PATH
dsh.connectionUrl	""	Connect to a running server; empty starts the CLI automatically
dsh.autoStart	true	Start dsh when the extension activates
dsh.autoConnectWorkspace	true	Create a workspace-rooted session after startup
dsh.cwdStrategy	workspace	Working directory for new sessions: workspace / firstWorkspace / host
dsh.agentPreset	standard	Agent preset for new sessions; standard renders the working directory + loads AGENTS.md, minimal does not
dsh.provider / dsh.model	""	Default provider / model for new sessions (empty = dsh default)
dsh.reasoningEffort	""	Default reasoning effort when the model supports it
dsh.webviewTheme	auto	Chat panel theme: follow VS Code or force light / dark
dsh.autoScrollThreshold	100	Auto-scroll threshold (px from bottom) during streaming
dsh.notifyOnChanges	true	Show a notification when the agent modifies files