dsh-reference-anything

<a name="readme-top"></a>

<h1>dsh-reference-anything</h1>

One @ for them all.

English · 简体中文

📰 News · 🧭 Roadmap · 📦 Installation · 🚀 Usage · [🐛 Report Bug][github-issues-link]

[![][stable-version-shield]][stable-version-link] [![][alpha-version-shield]][alpha-version-link] [![][typescript-shield]][typescript-link] [![][dsh-plugin-shield]][repository-link] <br/> [![][github-stars-shield]][github-stars-link] [![][github-forks-shield]][github-forks-link] [![][github-issues-shield]][github-issues-link] [![][github-license-shield]][github-license-link]<br/> [![][npm-downloads-shield]][npm-package-link]

Reference Anything is an enhancement for the DeepSeek Harness (DSH) @ menu. It brings files, sessions, local agents, web chats, cloud drives, and local plugins into one searchable menu, so you can mention the context you need without switching tools or copying content manually.

After typing @, you can browse and click items in the menu with your mouse, or use the keyboard to enter text, search, and narrow down the results. When a folder is selected, press Tab to enter it and continue browsing, or Enter to insert the folder reference.

Use one @ menu to reference:

• 🧩 DSH commands and Skills
• 📁 Workspace files and folders
• 💬 DSH session history
• 🖥️ Local Agent conversations: bundled scanning and read-only parsers for 30 source formats, including Claude Code, Codex and Cursor; optional import into DSH through Chat Import. Live acceptance coverage is recorded separately.
• ✨ Added by this plugin — highlight: Historical conversations from web chatbots including ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi
• ☁️ Added by this plugin: Files from cloud drives connected through OpenList
• 🧩 Added by this plugin: Installed and configured local DSH plugins, without repeatedly hunting through directories

Beyond extending what @ can reference, Reference Anything also enhances the @ menu itself:

• Customize visible groups: enable or hide Commands, Skills, files, DSH sessions, local agent conversations, external conversations, cloud-drive files, and local plugins, then arrange them in any order

• Customize shortcuts: assign your own shortcuts to source groups, web providers, local agents, and cloud-drive mounts

• Customize result counts: set each group's collapsed row count and hard candidate cap independently

• Choose how to browse: expand or collapse individual groups, or use DSH's native scrolling list

• Enhanced visual icons and commands: distinguish reference sources with type icons and platform logos

  <th width="50%">Native DSH display</th> <th width="50%">Reference Anything icon enhancements</th> <td width="50%"><img src="./images/at-files-native-comparison.png" alt="Native DSH file list" width="100%" /></td> <td width="50%"><img src="./images/at-files-enhanced-comparison.png" alt="Reference Anything file-type icon enhancements" width="100%" /></td>

Type @, search across enabled sources, and insert the selected reference into the current task. Each source keeps its own access and loading behavior: files use DSH's permission-constrained tools, DSH sessions use the native session-reference protocol, local agent transcripts are streamed straight off disk, cloud-drive files are fetched a window at a time over the drive's own API, and external conversation bodies are read on demand.

…