Introduction¶

On Windows, “letting the Agent find files” is an unavoidable requirement in agent development. Traditional approaches either involve letting the model recursively traverse directories (which is slow) or enabling Everything’s HTTP server or using es.exe (which adds an extra configuration step). dsh-tool-everything takes a different path: it registers an everything_search tool for the DSH (DeepSeek Harness) Agent, directly invoking the local Everything index to perform a full-disk search by filename with millisecond-level returns. Below is an introduction to its positioning, installation, and usage.

What is this¶

dsh-tool-everything is DSH’s Everything search tool plugin, maintained by roxyyn0304, and is licensed under the MIT License (as declared in both README and package.json).

Its functionality is focused: registering an everything_search tool for the DSH Agent. Once the Agent initiates a call, the plugin loads the built-in Everything64.dll via the koffi FFI, passes the query to Everything through the Everything SDK’s IPC channel, searches the full disk by filename using its NTFS index, and returns the results in a structured format: file path, file size, and whether it is a folder. The Everything64.dll is sourced from voidtools’ Everything SDK 1.5 and is distributed with the plugin.

Core Features¶

• Directly call the Everything SDK (via koffi FFI) using the IPC channel for millisecond-level response
• Supports complete search syntax: wildcards *.pdf, path:C:\code, ext:zip, size:>10mb, as well as regex:, | (OR), and ! (NOT)
• Returns structured results (path, size, is folder), automatically rendering search cards in the UI
• Zero-dependency installation: includes Everything64.dll; the system does not require additional components
• Zero configuration: no need to enable the Everything HTTP server, no es.exe, and no changes to any Everything settings
• DSH native Cordis plugin with HMR (Hot Module Replacement) support; no need to restart DSH after installation
• Implementation is contained in a single file lib/index.js as an ESM module

Installation and Enablement¶

First, confirm three prerequisites:

1. Windows system;
2. Everything is running;
3. The DSH profile’s node_modules contains koffi (built into DSH, generally no need to handle).

Then execute the installation command in PowerShell:

dsh plugin --profile web add "github:roxyyn0304/dsh-tool-everything"

After installation, perform two steps: hard refresh the browser (Ctrl+Shift+R), then open a new session; the everything_search tool will then be available.

Configuration¶

The plugin has three configuration items, with default values as follows:

Typical Usage¶

Agent-side call example (from technical details in README):

everything_search("npm", max=10)

What this step does: instructs the Agent to search for npm by filename across the entire disk, returning up to 10 results.

Combined with Everything’s search syntax, you can further filter results, for example:

*.pdf
path:C:\code
ext:zip
size:>10mb

These correspond to filtering by wildcard, path, extension, and file size, respectively. Syntaxes such as regex:, |, and ! are also available.

Error Codes¶

When the tool fails, it returns a clear error code to facilitate troubleshooting:

Implementation¶

The call chain is: DSH Agent calls everything_search → Plugin calls Everything64.dll via koffi FFI → Everything SDK uses IPC channel → Everything.exe completes the full-disk NTFS index search.

The plugin’s own dependencies are empty, and it declares a set of peerDependencies: @deepseek-ai/dsh-llm, @deepseek-ai/dsh-system-prompt, @deepseek-ai/dsh-tools, @deepseek-ai/dsh-timeout (^0.1.0-rc.6) as well as @deepseek-ai/schemastery (^3.18.1). Runtime dependencies are provided by DSH, and koffi is also bundled with DSH.

Suitable Scenarios and Notes¶

Suitable scenarios: Using DSH on Windows with Everything running persistently locally, and wanting the Agent to quickly locate files by filename (e.g., finding a certain type of file in a project directory or confirming which drive an installation package is on). The search is based on Everything’s filename index.

Additionally, a few points to note:

1. The plugin runs with the permissions of the current dsh process; it is recommended to check the source code and license before installation.
2. The plugin uses the MIT license, consistent with README and package.json declarations.
3. When encountering an error, cross-reference the error codes to troubleshoot: dll load failure, Everything not running, call terminated, corresponding to the three situations in the previous section.

Conclusion¶

dsh-tool-everything compresses “letting the Agent find files on the entire Windows disk” into a single tool call: Everything is running, the plugin is installed, and the Agent can search the entire disk by filename in milliseconds without needing extra services or configuration.

Plugin addresses:

• GitHub: https://github.com/roxyyn0304/dsh-tool-everything
• Community Plugin Directory Page: https://www.skillhub.cn/plugins/roxyyn0304/dsh-tool-everything (Community independent maintenance directory site, no official affiliation with DeepSeek or HF)