dsh-reference-anything

dsh plugin --profile web add dsh-reference-anything

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

<div align="center">

<img src="./images/logo.png" alt="dsh-reference-anything logo" width="180" />

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

One @ for them all.

English · [简体中文](./README_zh-CN.md)

[📰 News](#-news) · [🧭 Roadmap](#-roadmap) · [📦 Installation](#-installation) · [🚀 Usage](#-usage) · [🐛 Report Bug][github-issues-link]

<!-- SHIELD GROUP -->

[![][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]


</div>

<div align="center">

<img src="./images/demo.gif" alt="dsh-reference-anything demo" width="800" />

</div>

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 33 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

<table>

<tr>

<th width="50%">Native DSH display</th>

<th width="50%">Reference Anything icon enhancements</th>

</tr>

<tr>

<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>

</tr>

</table>

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.

The External conversations group — and only that group — uses OpenCLI to reach AI chat sessions you are already logged into. By default it stores conversation titles locally and the agent fetches remote content on demand; an optional offline-mirror mode stores the latest complete bodies locally instead. Local agent conversations need none of that: those transcripts are already files on your own disk, so that group reads them directly, with no browser, no OpenCLI, and nothing mirrored.

[!NOTE]

DSH is currently in Beta, so its underlying capabilities and interfaces may change as it evolves. This plugin will adapt alongside those changes. Because of some current DSH limitations, parts of the implementation may not yet be ideal; we will continue to follow DSH updates and improve the plugin over time. See the relevant sections below for specific limitations and usage notes.

📰 News

v0.5.2

Adds oh-my-pi, Copilot VS Code, Copilot CLI and Doubao Desktop references, restores scoped file/session searches with official references, and loads tutorial GIFs remotely on demand. Doubao requires cached local bodies; importing requires Chat Import 0.26.3+. [Release notes](./docs/release/0.5.2/README.md).

0.5.0 Preview · Feature Demos

This update also adds unified local pagination, resumable long-text reads and message/tool search, rechecks source switches on every read, and moves non-local tools to external_reference_list/read. See the [release and migration guide](./docs/release/0.5.0/README.md). See also the [v0.5.1 compatibility fixes](./docs/release/0.5.1/README.md).

Import Past Conversations into DSH and Pick Up Where You Left Off

Want to continue an existing local session without copying and pasting chat logs or treating old threads purely as static context?

Now, when you find a local session in the @ menu, you have two ways to use it:

• **Refere

…(truncated)