Skip to content
Back to search

dsh-at-file

SkillWorks with CodexGitHub

Codex-style @file mentions for DeepSeek Harness: search workspace files in the composer and attach their path to prompts.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fsmargoo--dsh-at-file/badge.svg)](/listings/fsmargoo--dsh-at-file)

HTML

<a href="/listings/fsmargoo--dsh-at-file"><img src="/api/listings/fsmargoo--dsh-at-file/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.7.0.tar.gz

Use the same command to update an existing installation. Restart `dsh web` after installation so the Host and browser client load version `0.7.0`.

Version `0.7.0` supports both the 0.1.1 and 0.1.2 Harness client package layouts. It also restores the default file ignores for installations that persisted an empty legacy list; clearing the list again in 0.7.0 remains an explicit choice.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 121 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dsh-at-file
  2. > [!IMPORTANT]
  3. > The latest official [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) release now includes built-in `@file` and `@session` reference features. Prefer the official implementation for new installations. This plugin remains available for existing setups and will be maintained occasionally on a best-effort basis.
  4. Workspace path references for the DeepSeek Harness web interface. Type `@` in the composer to search the current workspace and insert a file or directory path.
  5. ![@ path picker](assets/screenshots/workspace-path-picker.png)
  6. ![File reference in the composer](assets/screenshots/file-mention-composer.png)
  7. ## Usage
  8. Choose a result from the `@` menu. The selected path remains visible in the draft and can be opened or removed from the reference bar.
  9. ```text
  10. Review @docs/spec.pdf
  11. ```
  12. Before the agent starts a step, the plugin confirms that the path exists inside the active workspace. It then adds a short reference message:
  13. ```xml
  14. <workspace-reference path="docs/spec.pdf" kind="file" />
  15. ```
  16. The reference contains the workspace-relative path and its kind. The plugin does not open the referenced file or list the contents of a referenced directory. The agent can inspect the path with the tools available in the current session when the task requires it.
  17. Pasted text is treated as ordinary text by default. An `@path` copied from another application does not open the picker, appear in the reference bar, or create a workspace-reference marker. Turn off **Ignore @ mentions in pasted text** in **Settings -> File mentions** if you need the older behavior.
  18. File format and file size do not change this behavior. A PDF follows the same path-reference flow as any other workspace file.
  19. This mechanism applies to version `0.3.0` and later. Earlier releases read file content during submission and enforced file-size limits.
  20. ## Path Picker
  21. Plain queries match filenames. Exact names, prefixes, and compact matches rank ahead of looser results, without matching letters scattered across a long directory path.
  22. With an empty query, shallow paths appear before deeper entries; directories appear before files at the same depth. The scrollable menu exposes up to 50 candidates, so root-level files are not displaced by deeply nested directories.
  23. A query containing `/` matches path segments in order. For example, `src/view` can find `src/client/view.ts`. A trailing slash such as `src/` searches within that path.
  24. 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 for the next selection. `Enter` and pointer selection keep the existing behavior and finish the directory reference.
  25. Each result shows the complete filename first and its parent directory underneath. The menu expands to its 537px design width when space permits, and long filenames wrap instead of being ellipsized. Duplicate filenames also include the parent directory in the main label. Built-in SVG icons distinguish folders, source files, text, PDFs, images, data and configuration files, archives, and other files.
  26. The default index skips common version-control directories, IDE metadata, dependency trees, caches, and build output. The list covers VS Code, Visual Studio, JetBrains IDEs, Fleet, Eclipse, Android and Gradle, Xcode, CMake, Flutter, .NET, Unity, Unreal, and common JavaScript and Python output directories. OS metadata files named `desktop.ini`, `Thumbs.db`, and `.DS_Store` are excluded by default.
  27. ## Install or Update
  28. ```sh
  29. dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.7.0.tar.gz
  30. ```
  31. Use the same command to update an existing installation. Restart `dsh web` after installation so the Host and browser client load version `0.7.0`.
  32. Version `0.7.0` supports both the 0.1.1 and 0.1.2 Harness client package layouts. It also restores the default file ignores for installations that persisted an empty legacy list; clearing the list again in 0.7.0 remains an explicit choice.
  33. ## File Filters
  34. Open **Settings -> File mentions** to manage file-name filters.
  35. ![File mention settings with Exact and Regex rules](assets/screenshots/file-mention-settings.png)
  36. - **Global** contains rules shared by every workspace.
  37. - **Workspace** contains additional rules for the selected workspace path. Each workspace keeps its own list, and the panel shows the global rules it inherits.
  38. Each rule has its own matching mode and case setting:
  39. - **Exact** matches one complete basename. Path separators are not accepted.
  40. - **Regex** runs a JavaScript regular expression against the complete basename. It does not receive the parent directory or workspace path.
  41. - **Case-sensitive** can be enabled independently for any Exact or Regex rule. It is off by default.
  42. Rules are added and removed individually. An invalid regular expression is shown before saving and is also rejected by the Host. **Restore defaults** resets the global list to the built-in file names. **Clear workspace rules** removes only the selected workspace's additions.
  43. Settings are saved in the DSH web profile through the plugin's own Host connection. Existing string values in `ignoreFiles` and workspace lists continue to work as case-insensitive Exact rules. A change clears the affected index cache, so the next `@` search uses the saved rules.
  44. ## Configuration
  45. The available options apply to the path picker index:
  46. - `maxIndexedFiles` sets the maximum number of indexed workspace entries.
  47. - `ignoreDirs` replaces the built-in list of directory names excluded from the picker. Set it to `[]` to index every directory.
  48. Add the complete configuration to the selected profile's `cordis.patch.yml`. The usual path is `~/.dsh/profiles/web/cordis.patch.yml`.
  49. ```yaml
  50. - id: dsh-at-file
  51. config:
  52. maxIndexedFiles: 10000
  53. ```
  54. Omitting `ignoreDirs` keeps the built-in list. When you provide it, include every directory name you want excluded.
  55. ## Path Handling
  56. - The picker indexes regular files, directories, and symbolic links in the active workspace. Directory links are traversed through their workspace-relative alias, while links back to an ancestor are kept visible without being re-entered.
  57. - Global and workspace file-name filters are combined during the Host index walk, before entries count toward `maxIndexedFiles` or reach the browser.
  58. - The Host accepts workspace-relative paths. Absolute paths and paths that escape the workspace are ignored.
  59. - Reference markers are created from typed text and picker selections. Pasted `@` tokens are ignored when the default setting is enabled.
  60. - Clicking a referenced path uses the Harness `host.openPath` endpoint.
  61. - The picker index is cached per session for 30 seconds.
  62. - The reference dock only renders tokens that exist in the current session's settled workspace index. Unknown `@text` remains ordinary text.
  63. - An `@path` token cannot contain whitespace or another `@` character.
  64. - `maxIndexedFiles` limits picker results. A manually entered path can still be referenced when it exists inside the workspace.
  65. The active agent may lack a tool for a particular file format. DSH provides `read` for UTF-8 text and `read_image` for supported images. PDF support depends on the tools available in the session.
  66. ## Development
  67. ```sh
  68. pnpm install
  69. pnpm run check
  70. pnpm run test
  71. pnpm run build
  72. ```
  73. The development setup expects the official `deepseek-ai/deepseek-harness` repository at `../deepseek-harness`, its default clone directory. Built files under `lib/` are committed so profile installation does not require package build scripts.
  74. ## License
  75. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.