What is this?
dsh-rs (binary name dsh) is a Rust rewrite of a DeepSeek terminal coding agent. It works directly in a real code repository: it searches and reads code, applies patches, runs commands, and keeps long multi-turn sessions that can be saved, resumed, and compacted.
dsh-rs (binary name dsh) is a Rust rewrite of a DeepSeek terminal coding agent. It works directly in a real code repository: it searches and reads code, applies patches, runs commands, and keeps long multi-turn sessions that can be saved, resumed, and compacted.Is this an official DeepSeek product or a community reimplementation?It is an independent, unofficial community project. The agent kernel uses a fixed version of the official DeepSeek Harness as a behavioral reference, but is reimplemented in Rust with its own types, concurrency model, and safety boundaries rather than being a line-by-line port of the original TypeScript source.
It is an independent, unofficial community project. The agent kernel uses a fixed version of the official DeepSeek Harness as a behavioral reference, but is reimplemented in Rust with its own types, concurrency model, and safety boundaries rather than being a line-by-line port of the original TypeScript source.How do I install and run it?Install Rustup to get the pinned Rust 1.85.0 toolchain, then build and run the binary from the repository root. There is currently no supported stable release, precompiled package, or crates.io publish.
Install Rustup to get the pinned Rust 1.85.0 toolchain, then build and run the binary from the repository root. There is currently no supported stable release, precompiled package, or crates.io publish.Do I need a DeepSeek API key?Yes. The key is read only from the process environment at request time; you should never put a real key into prompts, tool arguments, or shell commands, since those are visible to the model and the session log.
Yes. The key is read only from the process environment at request time; you should never put a real key into prompts, tool arguments, or shell commands, since those are visible to the model and the session log.Is this stable enough to rely on?No - it is a 0.1.0-alpha.0 pre-release that has only passed internal Phase 0-11 acceptance testing, with no supported stable release, prebuilt binary, or crates.io package yet. Many listed features (vision, web search, LSP, Goal mode, Plan mode, skills) are explicitly marked experimental.
No - it is a 0.1.0-alpha.0 pre-release that has only passed internal Phase 0-11 acceptance testing, with no supported stable release, prebuilt binary, or crates.io package yet. Many listed features (vision, web search, LSP, Goal mode, Plan mode, skills) are explicitly marked experimental.What terminal interface does it use?By default dsh auto-detects an enhanced TUI (Composer editing, Dock, themes, animations) when the terminal supports color, is at least 44x12, and isn't tmux/Screen/Zellij; otherwise it falls back to a plain, zero-ESC linear interface, which can also be forced with --tui linear or NOCOLOR/TERM=dumb.
By default dsh auto-detects an enhanced TUI (Composer editing, Dock, themes, animations) when the terminal supports color, is at least 44x12, and isn't tmux/Screen/Zellij; otherwise it falls back to a plain, zero-ESC linear interface, which can also be forced with --tui linear or NOCOLOR/TERM=dumb.What is Goal mode?The /goal command sets a resumable objective. While idle, dsh automatically runs sequential turns (default cap 32) to advance it, until the model pauses, completes the goal, or gets blocked three turns in a row.
The /goal command sets a resumable objective. While idle, dsh automatically runs sequential turns (default cap 32) to advance it, until the model pauses, completes the goal, or gets blocked three turns in a row.What is Plan Mode?The /plan command switches the agent into a planning-only mode where it must submit a full Markdown plan via exitplanmode before making changes; you can approve it, send it back for revision, or exit with /plan off.
The /plan command switches the agent into a planning-only mode where it must submit a full Markdown plan via exitplanmode before making changes; you can approve it, send it back for revision, or exit with /plan off.Can I run it non-interactively in scripts?Yes, pass --prompt or pipe input to use script mode, which never waits for approval and automatically refuses any file-write or shell-execution request.
Yes, pass --prompt or pipe input to use script mode, which never waits for approval and automatically refuses any file-write or shell-execution request.What are similar projects?Proteus, ouroboros, oh-my-pi, operator-memory, codeAgent, deepseek-harness-for-vscode, cocode, dsh-router-standard
Proteus, ouroboros, oh-my-pi, operator-memory, codeAgent, deepseek-harness-for-vscode, cocode, dsh-router-standardWhich topics is it in?lsp, agent-harness, dsh, deepseek-harness, skills, deepseek, coding-agent, ai-agent, rust, command-line-tool, agent, terminal
lsp, agent-harness, dsh, deepseek-harness, skills, deepseek, coding-agent, ai-agent, rust, command-line-tool, agent, terminal