dsh-at-file: Codex-style @ File Mentions for DeepSeek Harness
omdsh-dev/dsh-at-file
DSH plugin to search workspace files with @ in the composer and attach path references to prompts.
Quickly search and reference workspace files in the DeepSeek Harness composer without typing full paths.
dsh plugin --profile web add github:omdsh-dev/dsh-at-file- Category
- Tools & Capabilities
- Platform
- DSH-Plugin
- Author
- omdsh-dev
- Distribution
- Plugin
dsh-at-file Key Features
dsh-at-file Repository
dsh-at-file Repo Summary
dsh-at-file is a DeepSeek Harness (DSH) plugin that brings Codex-style @ file mentions to the web interface. It solves the problem of quickly finding and referencing workspace files in the composer without typing full paths. Core capabilities include a path picker, file filter rules, and workspace path validation before agent steps. The plugin is maintained by omdsh-dev, licensed under MIT, and last updated in 2026-08.
How does the @ path picker in dsh-at-file work?
Type @ in the composer to trigger the path picker, which searches the current workspace for files and directories. Plain queries match filenames, with exact names, prefixes, and compact matches ranking higher. Queries containing / match path segments in order, e.g., src/view can find src/client/view.ts. When a directory is highlighted, press ArrowRight to enter it; the draft advances to @path/ without a trailing space, and the candidate menu stays open. Each result shows the filename first and its parent directory underneath, with built-in SVG icons distinguishing folders, source files, text, PDFs, images, data, config, archives, and other types. The default index skips common version-control directories, IDE metadata, dependency trees, caches, and build output.
How do I install or update dsh-at-file?
To install or update dsh-at-file, use the following command. After installation, restart dsh web to load the new version:
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.0.tar.gz
How do I configure file filters in dsh-at-file?
Manage file-name filters under Settings -> File mentions. Global rules apply to every workspace, while Workspace rules apply only to the selected workspace. Each rule supports Exact (matches one complete basename) or Regex (JavaScript regular expression) modes, with independent case-sensitivity toggles. Invalid regexes are flagged before saving and rejected by the Host. Restore defaults resets the global list to built-in file names, and Clear workspace rules removes only the selected workspace's additions. Settings are saved to the DSH web profile via the plugin's own Host connection.
How does dsh-at-file handle referenced paths?
Before the agent starts a step, the plugin confirms that the path exists inside the active workspace and adds a short reference message, e.g., <workspace-reference path="docs/spec.pdf" kind="file" />. The plugin does not open the referenced file or list directory contents; the agent can inspect the path with available tools when needed. File format and size do not change this behavior—a PDF follows the same path-reference flow as any other file. This mechanism applies to version 0.3.0 and later; earlier releases read file content during submission and enforced file-size limits.
What are the compatibility and license of dsh-at-file?
As part of the DeepSeek Harness ecosystem, this DSH plugin depends on official packages like @deepseek-ai/dsh-agent and @deepseek-ai/dsh-client-runtime, ensuring deep integration. The project is licensed under MIT, maintained by omdsh-dev, with 245 stars and 9 forks, last updated on 2026-08-14.