A native dsh web plugin for Codex-style @file mentions: type `@` in the composer to insert workspace-relative file / directory path references without pasting file contents.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-22
License
MIT
01What can it help you accomplish?
Reference workspace files by path inside the DeepSeek Harness web composer
Type `@` to open a workspace path picker that searches the active workspace and inserts a workspace-relative file / directory path as a reference marker — Codex-style @file mentions without pasting file contents
DeepSeek Harness web users who want to point the agent at files by path instead of pasting full contents into the prompt
Point the agent at files while keeping file contents out of the prompt
The plugin inserts only a `<workspace-reference path=… kind=… />` marker; it does not open the file or list directory contents, and only resolves paths that live inside the active workspace
Teams that want lightweight file pointers but prefer the agent's actual reads to stay under its own session tools
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness with the web interface (`dsh web`) and a web profile
- A workspace opened in the dsh web client where you want @file mentions
Installation steps
- 01
Add the plugin to your web profile (the README documents the archive URL; the repo now publishes under `fsmargoo`): `dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz`
$ dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz
- 02
Restart `dsh web` so the Host and browser client load version `0.6.7`
$ dsh web
- 03
(Optional) Configure the picker via `~/.dsh/profiles/web/cordis.patch.yml` — e.g. `maxIndexedFiles: 10000` — and reload the profile
Verify the integration
- After restarting `dsh web`, open the composer and type `@`; a workspace path picker should appear and let you insert a file / directory reference
03DSH integration and capability boundaries
Native DeepSeek Harness (`dsh`) web plugin. Install it into a web profile with `dsh plugin --profile web add …`, then type `@` in the dsh web composer to open a workspace path picker that inserts file / directory references. It wires into the dsh Host (its own Host connection) and reads config from `~/.dsh/profiles/web/cordis.patch.yml`.
@ path picker
a query typed after `@` in the dsh web composer→ranked workspace file / directory results (plain names, `/`-segment matching, directory drill-down with ArrowRight), inserting a workspace-relative path
workspace-reference marker
a selected file or directory from the picker→a `<workspace-reference path=… kind=… />` marker kept visible in the draft; the agent can inspect the path with its own session tools when the task requires it
does not open the referenced file or list directory contentsfile filters & picker config
Settings → File mentions rules (Global / Workspace, Exact / Regex, case-sensitive) and `cordis.patch.yml` options→a scoped picker index via `maxIndexedFiles` and `ignoreDirs`; a change clears the affected index cache so the next `@` search uses the saved rules
clears the index cache for the affected scope on change
04Who is it for? When not to use it?
Good for
- DeepSeek Harness web users who want to point the agent at files by path instead of pasting full contents into the prompt
- Teams that want lightweight file pointers but prefer the agent's actual reads to stay under its own session tools
05Compatibility, maintenance and safety notes
- Requires the DeepSeek Harness web interface (`dsh web`) and a web profile; the plugin is added with `dsh plugin --profile web add …` and you must restart `dsh web` for the Host and browser client to load the new version.
- Only workspace-relative paths are accepted; absolute paths and paths that escape the workspace are ignored. The plugin never reads file contents — it inserts a path-only reference, so actual file reads stay under the agent's own session tools. Pasted `@` tokens are ignored by default.
- The path-reference flow applies to version 0.3.0 and later. Earlier releases read file content during submission and enforced file-size limits, so behavior differs on old installs.
MIT · actively maintained (latest release v0.6.7, 2026-08-20)
06Frequently asked questions
How do I install dsh-at-file into DeepSeek Harness?
Add it to a web profile with `dsh plugin --profile web add …` (the README documents the v0.6.7 archive URL), then restart `dsh web` so the Host and browser client load the new version. Built files under `lib/` are committed, so no build step is needed.
What does typing `@` do?
It opens a workspace path picker inside the dsh web composer. You can search by filename, use `/` to match path segments (e.g. `src/view`), drill into directories with ArrowRight, and insert a file or directory reference into your draft.
Does the plugin read or expose my file contents?
No. It inserts only a workspace-relative path reference (`<workspace-reference path=… kind=… />`). It does not open the file or list directory contents; the agent reads the path later through its own session tools if the task needs it.
How do I control which files show up in the picker?
Open Settings → File mentions to add Global and Workspace rules (Exact name or Regex, with optional case-sensitivity). You can also set `maxIndexedFiles` and `ignoreDirs` in `~/.dsh/profiles/web/cordis.patch.yml`.
Which DeepSeek Harness versions are supported?
The path-reference flow applies to version 0.3.0 and later. Earlier releases read file content during submission and enforced file-size limits, so behavior differs on older installs.
07Related DSH workflows
petdex
by crafter-station
A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.
dsh-deep-whale
by small-tailqwq
DSH Web GUI 鲸鱼娘主题皮肤（深海女仆工坊 maid-atelier：亮/暗双模式）
awesome-dsh-plugin
by anil-matcha
A curated list of plugins for DeepSeek Harness (dsh) - DeepSeek Harness plugin ecosystem
working-activity
by ccch1mneyyy
Lively Working-line extension for pi CLI and DSH
08Data and sources
Workspace path references for the DeepSeek Harness web interface. Type `@` in the composer to search the current workspa…
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-22. Found an error? Submit a correction.