dsh-wsl-picker

Readme

# dsh-wsl-picker
> **Install set:** part of [dsh-wsl-kit](https://github.com/173787247/dsh-wsl-kit). Prefer `KIT_SET=daily` | `llm` | `github` | `full` (see kit README). Fault tree: [TROUBLESHOOTING.md](https://github.com/173787247/dsh-wsl-kit/blob/master/docs/TROUBLESHOOTING.md).


DeepSeek Harness plugin: Browse WSL directories from / and /mnt Windows drives for workspace picking.

Part of **[dsh-wsl-kit](https://github.com/173787247/dsh-wsl-kit)**.

[中文说明 → README.zh.md](./README.zh.md)

## Where it sits

Lists WSL directories under / and /mnt so a workspace can be picked. It does not register IM workspaces.

```mermaid
flowchart LR
  agent["dsh agent"] --> tool["wsl_picker"] --> fs["/ and /mnt listings"]
```

Suite diagram and version snapshot: [dsh-wsl-kit](https://github.com/173787247/dsh-wsl-kit#how-the-pieces-fit). This plugin is **0.1.1** (full). Do not copy that matrix into this README.


## Compatibility

| Field | Value |
|-------|-------|
| **Plugin** | `dsh-wsl-picker` **0.1.1** |
| **Minimum dsh** | ≥ **0.1.2** (web UI one-shot `?token=` on Windows relay `:3081`) |
| **Latest verified** | See [dsh-wsl-kit Compatibility](https://github.com/173787247/dsh-wsl-kit#compatibility-2026-09) (currently **`0.2.0-rc.2`**) — single source of truth for the suite |
| **Kit set** | `full` or install alone |
| **Cloud Flash** | Use model id **`deepseek-flash`** (V4.1 Flash) in `~/.dsh/settings.yaml` / `llm-deepseek` — not configured by this plugin |
| **Agent Teams** | Upstream experimental; not required here |

Suite floor versions: kit [`check-plugin-versions.sh`](https://github.com/173787247/dsh-wsl-kit/blob/master/scripts/check-plugin-versions.sh). Fault tree: [TROUBLESHOOTING.md](https://github.com/173787247/dsh-wsl-kit/blob/master/docs/TROUBLESHOOTING.md).

## Install

```sh
dsh plugin --profile web add github:173787247/dsh-wsl-picker
# or local:
dsh plugin --profile web add /absolute/path/to/dsh-wsl-picker
```

Restart `dsh web` and open a **new** session. Tool: `wsl_picker`.

| Arg | Meaning |
|-----|---------|
| `path` / `start` | Directory to list; `start` preferred. Empty `start` or `im` → `~/.dsh/im-workspace` |
| `filter` | Case-insensitive substring on entry names |
| `showHidden` | Include dotfiles |

## License

MIT