dsh-multi-root

DSH's web GUI was built around a single working directory. When your source code, configs, and documentation live in several independent folders, every operation means manually switching context. dsh-multi-root brings a VS Code-style multi-root workspace to DSH: attach any number of folders from a sidebar panel, and all roots are equal, shared across every session and agent, hot-pluggable via a cordis bundle with zero DSH source changes.

The real payoff shows up on the agent side. The plugin registers five workspace tools into DSH's tool pipeline: list the root set, list a directory, read a file (256 KB cap with truncation reported), write a file (auto-creates parent directories, 5 MB cap), and glob-match (1,000 result cap). An agent calls workspace_roots to discover every attached root, then uses the remaining tools to operate inside any of them without the user needing to spell out paths. On the GUI side, a path input and a native directory browser (starting at the drive level on Windows, the home directory on Linux and macOS) make attaching folders straightforward, with a live status indicator on each row showing whether the directory is available or missing.

Security is enforced at every operation: paths are joined root-relative, canonicalized with fs.realpath, and verified to stay inside the registered root. Path traversal, absolute paths, drive letters, and symlinked escapes are rejected on both read and write; globbing never follows symlinks; all API routes are loopback-only. The trust boundary is simply the set of roots the user attached in the GUI, and agents can never add or remove roots themselves. If you find yourself juggling multiple independent directories in DSH — source in one repo, configs in another, docs in a shared folder — dsh-multi-root is built for exactly that workflow.