Introduction

dsh-bash-native is a DSH plugin maintained by SpookyWaste, designed to provide a native POSIX bash execution environment on Windows. It is implemented in Rust, does not rely on WSL or MSYS compatibility layers, can run bash scripts directly on Windows, and aligns with DSH’s permission policies.

Core Features

  • Native binary execution: A native program written in pure Rust, with no overhead from a virtual machine or emulation layer.
  • Three-tier permission policies: Fully compatible with DSH’s permission control mechanism.
  • Background job support: Supports running tasks in the background.
  • Persistent terminal: Supports preserving terminal session state.

Installation and Dependencies

Before installing, ensure the environment meets the following requirements:

  • DSH version: >= 0.2.0-rc.2
  • Node version: >= 22.12.0
  • Platform: Windows x64 only

The installation command is as follows:

dsh plugin --profile web add dsh-bash-native

Enable Configuration

After installation, enable the plugin in DSH settings:

  1. In Settings → General, set Native Bash (Windows) as the default preset, or switch to this preset when creating a new session.
  2. The persistent terminal component is disabled by default. Go to the plugin management interface and manually enable it to use the persistent terminal feature.

Notes

  • This plugin is open source under the MIT License.
  • The persistent terminal feature requires DSH >= 0.2.1-alpha.2 to function correctly.
  • Because it is a native Windows implementation, pay attention to path and command compatibility across different environments.

Conclusion

This plugin addresses compatibility-layer and performance overhead issues when using Git Bash or WSL on Windows. If you need to perform automation in a native Windows environment within DSH, this is a suitable choice.

GitHub repository
Plugin directory