A DSH plugin that fixes minimal-mode bash on Windows by routing it through Git for Windows (MSYS), with idempotent install and sandbox-aware gating.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-24
License
MIT
01What can it help you accomplish?
Make DSH minimal mode work on Windows by routing bash to Git for Windows (MSYS)
An installable agent preset that runs bash commands through git bash, with sandbox-aware gating
Windows users of DeepSeek Harness (dsh) who need the minimal-mode bash tool
02How to install into DeepSeek Harness
Prerequisites
- Git for Windows installed (provides bash / MSYS)
- DeepSeek Harness (dsh) with the web profile
Installation steps
- 01
Run `dsh plugin --profile web add @icelily/dsh-gitbash-preset`
$ dsh plugin --profile web add @icelily/dsh-gitbash-preset
- 02
Or merge `cordis.patch.yml` into the profile patch layer manually
- 03
Restart DSH — the plugin installs the preset automatically on startup (no-op if already present)
Verify the integration
- In the web UI, create a new session and select the **极简模式 (Git Bash)** preset
03DSH integration and capability boundaries
DSH agent preset delivered via cordis.patch.yml; maps minimal-mode bash to Git for Windows bash (MSYS)
Idempotent preset install
DSH startup in the web profile→Copies the bundled preset to `${DSH_HOME:-~/.dsh}/.agent-presets/minimal-gitbash/`; skips if present, `force: true` to overwrite
Writes preset files under the user's DSH_HOME preset rootAutomatic bash detection
DSH host environment→Resolves bash via `GIT_BASH` env → common install dirs → `bash.exe` on PATH → fallback `bash`
Sandbox-aware gating
bash run / start requests→Executes only under `danger-full-access` (or no sandbox deployment); otherwise throws a clear upgrade guide
Commands are blocked unless the full-access policy is active
04Who is it for? When not to use it?
Good for
- Windows users of DeepSeek Harness (dsh) who need the minimal-mode bash tool
Not for
- Built for Windows. DSH's minimal mode originally fails on win32 because the PTY backend is unsupported and bash is absent from PATH.
- Bash only runs under the full-access sandbox policy; under restricted policy the model must upgrade via `sandbox_permissions: "danger-full-access"` with justification.
- Requires Git for Windows (MSYS bash). Without it, bash resolution falls back to bare `bash`, which won't exist on a default Windows install.
05Compatibility, maintenance and safety notes
- Built for Windows. DSH's minimal mode originally fails on win32 because the PTY backend is unsupported and bash is absent from PATH.
- Bash only runs under the full-access sandbox policy; under restricted policy the model must upgrade via `sandbox_permissions: "danger-full-access"` with justification.
- Requires Git for Windows (MSYS bash). Without it, bash resolution falls back to bare `bash`, which won't exist on a default Windows install.
MIT · no latest release (latest_release: null)
06Frequently asked questions
Why does DSH minimal mode fail on Windows?
Two reasons: the persistent bash relies on a PTY backend that `@deepseek-ai/dsh-subprocess-local` refuses on win32 (`terminal inspection is unsupported on platform win32`), and `@deepseek-ai/dsh-bash-local` hardcodes a PATH lookup for `bash`, which Windows doesn't have by default.
How do I install dsh-gitbash-preset?
Run `dsh plugin --profile web add @icelily/dsh-gitbash-preset`, or merge `cordis.patch.yml` into your profile patch layer manually. Restart DSH — the plugin installs the preset on startup (no-op if it already exists).
Why is bash only allowed under full-access sandbox?
MSYS can't start inside a Windows restricted-token sandbox (it can't create the signal pipe), so the executor only runs under `danger-full-access` (or a no-sandbox deployment); otherwise it throws a clear upgrade guide instead of bypassing the sandbox.
How does it find Git for Windows bash?
It checks the `GIT_BASH` env var, then common install directories (ProgramFiles / ProgramFiles(x86) / LOCALAPPDATA), then `bash.exe` on PATH, and finally falls back to bare `bash` — no hardcoded path required.
Can I install the preset without the plugin?
Yes — copy the `agent-presets/minimal-gitbash/` directory into `~/.dsh/.agent-presets/` directly, without installing the plugin.
07Related DSH workflows
dsh-routing-suite
by yjh051108
dsh-routing-suite — injector + router-standard kit: install the runtime injector first, then the task-aware reasoning-mode router preset (measured P1-P23).
brooks-lint
by hyhmrright
AI code reviews grounded in 12 classic engineering books — decay risk diagnostics with book citations, severity labels, and 6 analysis modes including full-sweep auto-fix
dsh-plugin-shop
by livxue
The most comprehensive DeepSeek Harness plugin market — refreshed daily, sourced across the Internet, reviewed before publishing.
dsh-our-free-model
by zouyuxuan122
Adds selectable remote models, availability checks, a local token dashboard, and an optional authenticated local forwarding endpoint.
08Data and sources
把 DSH 自带极简模式中的 bash 调用映射到 Git for Windows 的 bash（MSYS），让 Windows 上的极简模式真正可用。
`cordis.patch.yml` 在 web profile 组合中插入 `dsh-gitbash-preset`，启动时安装预设文件
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-24. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.