dsh-plugins

The base DeepSeek Harness bundle ships no model-facing directory-listing tool by design, so agents are stuck reaching for bash ls—unstructured output, bound by whatever shell sandbox the deployment happens to mount—or glob, which is pattern-driven rather than hierarchical. On top of that, the default session-query index is mounted with path :memory: and openAt never, meaning every full-text call bails out with SESSION_QUERY_SEARCH_DISABLED and the Web sidebar can only fuzzy-match titles and workspace names.

dsh-plugins fills both gaps with two small, focused contributions. list_dir is a native Consumer of the filesystem seam: it returns the direct children of a directory by name, type, and size without ever reading file contents. Because it talks to the seam instead of shelling out, it transparently follows whichever provider the deployment mounted—local, sandboxed, or remote. The tool registers globally, so every agent preset can call it out of the box; the optional limit parameter defaults to 200 and is clamped at 1000, with a truncation notice on the last line when the cap is hit.

The other piece is a home patch layer that applies to every profile. It re-points the session-query index to a durable path and sets openAt to first-search, which makes full-text retrieval actually work while keeping the node:sqlite import and the file handle off the startup critical path. Changes hot-reload on save. The whole bundle is plain ESM JavaScript with zero build steps, making it a practical pick for DeepSeek Harness users who want their agents to browse directories in a structured way and who need in-session full-text search that the defaults leave disabled.