dsh-plugin-knowra: Let DeepSeek Harness Agents Search arXiv and Read Scout Reports
rexopia/dsh-plugin-knowra
Knowra for DeepSeek Harness lets your DSH agent search arXiv papers by topic, author or exact dates and read Scout reports on methods, evidence and limitations, so you can decide which papers deserve a close read.
dsh-plugin-knowra is an academic search plugin for DeepSeek Harness that hands arXiv paper search and Scout report reading to your agent. It targets the problem of too many papers and no quick way to judge which deserve a close read: Scout reports lay out each paper's methods, evidence and limitations so you can shortlist before reading deeply. Search works by topic, author or exact dates without an account, while reading Scout reports requires a personal API key created in your account and injected. The plugin contains only a configuration patch, runs no extra code locally, and is maintained by Rexopia under the MIT license.
How to Install
dsh plugin --profile <your-profile> add dsh-plugin-knowraReplace --profile with the profile name you actually run (see ls ~/.dsh/profiles/): usually web in the browser UI, desktop or desktop-NNN in the desktop app.
- Category
- Data & Knowledge
- Platform
- DSH Plugin
- Author
- rexopia
- Distribution
- Plugin
dsh-plugin-knowra Key Features
dsh-plugin-knowra Repo Summary
What Does It Do?
Knowra is a DSH plugin for DeepSeek Harness that lets your agent search arXiv papers by topic, author or exact dates and read Scout reports on each paper's methods, evidence and limitations. It solves the problem of too many papers and no quick way to judge which ones deserve a close read, so you can shortlist first and read deeply later. The plugin ships no local code; it points the harness's official MCP client at the Knowra service, and search works without an account.
Core Features
- Paper search: queries arXiv titles, authors and abstracts, with optional UTC date windows starting from 2025-08-01, and needs no API key.
- Scout reports: reads the Scout report for a paper from the search results, laying out its methods, evidence and limitations; this requires a personal API key.
- Usage check: shows your remaining Scout allowance and reset time so you know when to upgrade to Pro.
- Lightweight integration: the package contains only a configuration patch that connects the official MCP client to Knowra, so nothing extra runs on your machine.
- Clear privacy boundary: Knowra receives only the tool requests your agent sends, not your conversation.
How to Use This Plugin?
After enabling it in DSH, just ask the agent for what you need, for example: find papers on memory for LLM agents from the past week, shortlist the relevant ones and read their Scout reports. Search works right away; to read Scout reports, create a personal API key in your Knowra account and inject it as described in the README, either through an environment variable or the desktop configuration file, then restart DSH. Keep the key out of chats and tool arguments, and revoke it any time from your account. The plugin is maintained by Rexopia under the MIT license, with its site at knowra.app/mcp.
How to Troubleshoot This Plugin?
If search works but reading Scout reports fails, the usual cause is a missing or unloaded personal API key: make sure the key is injected before DSH starts, and on the desktop app check that the authorization header in the configuration file is complete, then restart DSH. If your allowance is exhausted, use the usage check to see the reset time, or upgrade to Pro as described in the official docs.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: rexopia/dsh-plugin-knowra. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
