Preface¶
When conducting technical research within DeepSeek Harness (DSH), the common practice involves writing scripts ad hoc, manually opening GitHub or various package managers to look up information, and then pasting the results back into the conversation. This fragmented process is also prone to encountering API rate limits. If you want the agent to directly query repositories, issues, release records, package dependencies, or community discussions within a single session, a unified read-only tool layer is required.
Here we introduce the community plugin dsh-github-intelligence (maintained by zoahdev). It packages query capabilities for GitHub and 16 other external developer ecosystems into DSH. The current version registers 201 read-only tools and includes built-in rate-limit-friendly TTL caching.
What is this¶
dsh-github-intelligence is a networked tool-type plugin for DSH, positioned as a “developer intelligence” integration. It covers GitHub, GitLab, Gitee, npm, PyPI, crates.io, Docker Hub, Hugging Face, Hacker News, Stack Overflow, Reddit, dev.to, RubyGems, NuGet, Go, ArXiv, and even the DSH plugin registry itself. Public interfaces do not require an API key; with a token, you can increase GitHub rate limits and enable notification-related tools.
The plugin is released under the MIT license, currently at npm version 2.10.0, with approximately 10 stars on GitHub. The complete tool catalog is available at: https://zoahdev.github.io/dsh-github-intelligence/
Core Features¶
GitHub Side¶
The README lists representative tools as follows:
| Tool Name | Function |
|---|---|
github_repo |
Repository overview: stars, forks, issues, languages, licenses, topics, default branch, etc. |
github_releases |
Recent releases, including tags, dates, and pre-release flags. |
github_issues |
Lists issues by status (automatically excluding Pull Requests). |
github_pulls |
Lists Pull Requests by status and merge state. |
github_contributors |
Lists major contributors by commit count. |
github_search |
Searches repositories by stars or recent updates. |
github_repo_report |
One-shot deep report: overview, latest release, open issues, recent commits, major contributors. |
github_compare |
Side-by-side comparison of two repositories with numerical differences. |
github_trending |
Trending new repositories sorted by stars (optional language filter). |
github_user_repos |
A user’s repositories sorted by stars. |
github_weekly_digest |
Summary of releases, merged PRs, new issues, and commits within a configurable lookback window. |
github_notifications |
Authenticated maintainer inbox: @ mentions, review requests, assignments, self-initiated threads, etc. |
github_repo_health |
Repository health score with evidence, risk items, and improvement suggestions (not a security audit). |
github_help |
Lists the directory of approximately 200 other tools; call this first if unsure which tool to use. |
Multi-Ecosystem & Generic Capabilities¶
Besides GitHub, the same installation package provides query tools for GitLab, Gitee, npm, PyPI, crates.io, Docker Hub, Hugging Face, Hacker News, Stack Overflow, Reddit, dev.to, RubyGems, NuGet, Go, ArXiv, and other ecosystems, as well as DSH registry statistics. All requests support cancellation signals (exec.signal), and responses are cached in memory by default via TTL caching. Composite tools (like github_repo_report) reuse caches from sub-calls to reduce redundant HTTP requests.
Two key new tools in v2.10.0 are github_notifications and github_repo_health. The former groups GitHub notifications for authenticated users by type; the latter provides a 100-point maintenance heuristic score, complete with evidence and specific suggestions.
Installation and Activation¶
The official installation command is as follows. First, add it within DSH, then restart dsh web.
dsh plugin --profile web add dsh-github-intelligence
If using the upstream CLI directly, you can use:
pnpm dlx @deepseek-ai/dsh plugin --profile web add dsh-github-intelligence
You can also install a standalone CLI globally (same tool catalog, for manual debugging):
npm install -g dsh-github-intelligence
After installation, restart dsh web and have the agent call the tools mentioned above in conversation. The README notes that it has been tested in an environment with dsh 0.1.0-rc.6, Node 24 / pnpm 11.
Optional Configuration¶
The following options can be set in cordis.yml:
| Configuration Item | Type | Default Value | Description |
|---|---|---|---|
githubToken |
string | None | GitHub token for increasing rate limits; enables github_notifications when granted notification read permissions. Do not commit to version control. |
timeoutMs |
number | 10000 |
Request timeout in milliseconds. |
defaultLimit |
number | 5 |
Default number of items when the model does not specify a limit. |
bodyPreviewChars |
number | 500 |
Maximum character count for release body previews. |
cacheTtlMs |
number | 60000 |
In-memory cache TTL in milliseconds. |
userAgent |
string | dsh-github-intelligence/2.10.0 |
User-Agent sent to the GitHub API. |
Typical Usage¶
The example prompts provided in the README can be reproduced directly:
- “Give me a full report on
deepseek-ai/deepseek-harness.” - “What open issues does
ollama/ollamahave right now?” - “Who are the top contributors of
openai/openai-python?” - “Find the top 5 TypeScript agent frameworks and compare their stars.”
- “What needs my attention on GitHub right now?”
- “Audit the repository health of
owner/repoand tell me exactly what to fix.”
The corresponding mappings are roughly: deep repository report, open issue query, contributor statistics, cross-repository comparison, authenticated notification inbox, and repository health audit. If unsure about the tool name, you can first have the agent call github_help to browse the complete catalog.
Use Cases and Notes¶
Who is this suitable for?
- Developers who need to query the status of open-source repositories, releases, issues/PRs, contributors, or cross-platform package information within DSH conversations.
- Maintainers overseeing multiple GitHub repositories who want the agent to summarize pending notifications or perform repository health checks.
- Scenarios involving technical selection or dependency research, where a single installation covers queries across multiple developer ecosystems.
Usage Notes
- The plugin runs with the permissions of the current
dshprocess. Before installation, it is recommended to read the source code and the MIT license to confirm acceptance of its network access scope. - Although public tools do not require a key, anonymous access is still subject to rate limiting constraints from each platform. When encountering 429 errors, the plugin returns actionable error messages. Configuring
githubTokencan alleviate rate limiting on the GitHub side. github_repo_healthprovides a maintenance heuristic score. The README explicitly states it is not a security audit and should not replace dedicated security scanning.- Some sources have restrictions on cloud IPs (e.g., the README mentions Reddit may block cloud IPs; residential networks are more stable).
- The DSH plugin directory SkillHub is a community site with no official affiliation with DeepSeek / High-Flyer. The plugin list and GitHub repository are based on maintainer releases.
Conclusion¶
dsh-github-intelligence consolidates developer intelligence queries scattered across multiple platforms into a set of read-only tools: broad coverage of 16 external ecosystems and deep GitHub capabilities, with composite reports and caching designed for rate-limit scenarios. If you are expanding the networked research capabilities of DSH, you can start by understanding the overview from the catalog page, then visit GitHub for installation instructions and the full tool list.
- Catalog page: https://www.skillhub.cn/plugins/zoahdev/dsh-github-intelligence
- GitHub: https://github.com/zoahdev/dsh-github-intelligence
- Online tool catalog: https://zoahdev.github.io/dsh-github-intelligence/