Skip to content

AngelosZou/dsh-multi-folder

30Last commit Aug 15, 2026

dsh-multi-folder DSH plugin

dsh-multi-folder is a plugin for DeepSeek Harness (DSH) that equips a project with multiple secondary working directories. The agent maintains its primary workspace but gains the same read/write/edit/execute permissions on the configured secondary directories under Workspace Write mode, enforced by re-rooting the sandbox policy. Directory lists are injected into the system prompt, and configuration changes are delivered via a non-interrupting message queue.

How to install the dsh-multi-folder DSH plugin

dsh plugin --profile web add dsh-multi-folder

Copying does not run this command. Review the repository and version before installing the dsh-multi-folder DSH plugin.

dsh-multi-folder DSH plugin data source

dsh-multi-folder DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-multi-folder DSH plugin can do

  • Supports multiple secondary working directories per workspace.
  • Automatically re-roots sandbox policy for Workspace Write mode on secondary directories.
  • Injects directory list into the system prompt, re-rendered per session assembly.
  • Notifies agent of configuration changes through a non-interrupting message queue.
  • Allows configuration before session starts via a sessionless remote API.
  • No new tools introduced; all changes are framework-level interception and UI modifications.

Where the dsh-multi-folder DSH plugin fits

  • Edit a source repository, a test repository, and a documentation repository side by side in the same DSH session.
  • Manage multiple related codebases (e.g., frontend, backend, and configuration) within a single DSH project.
  • Allow the agent to perform cross-repository operations (read, write, execute) on configured directories without leaving the primary workspace.

Who the dsh-multi-folder DSH plugin is for

  • Developers who need to work on multiple interconnected repositories simultaneously within DSH.
  • Teams using DSH for complex projects that involve separate codebases for different components.

dsh-multi-folder DSH plugin limitations

  • Requires Node.js >= 20 and a DSH profile composed of @deepseek-ai/dsh-base + @deepseek-ai/dsh-web-app.
  • Plugin installation requires restarting the DSH backend and refreshing the browser page to take effect.
  • Agent cannot self-grant directories; configuration is user-managed by design (security boundary).

dsh-multi-folder DSH plugin: from the repository README

Quoted from the AngelosZou/dsh-multi-folder README, the upstream source of the dsh-multi-folder DSH plugin. Copyright remains with the original authors.

**English** | [中文](README.zh.md) > Secondary working directories for a DeepSeek Harness project — edit a source repo, a test repo, and a docs repo side by side without leaving the primary workspace. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Node.js >= 20](https://img.shields.io/badge/Node.js-%3E%3D20-brightgreen)](https://nodejs.org/) [![npm version](https://img.shields.io/npm/v/dsh-multi-folder)](https://www.npmjs.com/package/dsh-multi-folder) [![GitHub issues](https://img.shields.io/github/issues/AngelosZou/dsh-multi-folder)](https://github.com/AngelosZou/dsh-multi-folder/issues) [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin bundle that gives one project (workspace) a set of **secondary working directories**: - The agent's core `cwd` and every other core attribute keep pointing at the **primary workspace**. - Under **Workspace Write** mode the agent gains the **same read / write / edit / execute permissions** on the configured secondary directories as on the primary workspace — enforced by re-rooting the sessio

Read the full READMERepository license: MIT

dsh-multi-folder DSH plugin questions

How do I install dsh-multi-folder?

Run `dsh plugin --profile web add dsh-multi-folder` in your terminal. Then restart the DSH backend (host composition loads at process start) and refresh your browser page (the client bundle is served no-cache).

How do I add a secondary directory to my session?

You can use the Multi-folder button in the session header panel, or use the slash command `/multi-folder add "D:\path\to\repo"`. The panel also appears on the session-creation page for configuration before the session starts.

Can the agent access the secondary directories?

Yes, under Workspace Write mode the agent has the same read/write/edit/execute permissions on the configured secondary directories as on the primary workspace. The sandbox policy is re-rooted automatically. Read-only mode still denies access.

Do I need to restart DSH after changing the directory list?

No, directory changes are applied immediately and the agent is notified at the next message boundary. You only need to restart the backend and refresh the browser after installing the plugin for the first time.

What configurations are required for this plugin to work?

Node.js >= 20 and a DSH profile composed of `@deepseek-ai/dsh-base` + `@deepseek-ai/dsh-web-app`. The plugin is designed to work with those packages.