Plugin directory / Developer / dsh-plugin-github-search
dsh-plugin-github-search
Verified · install-tested on dsh Tianbaidi
What it does
A plugin in the Developer category for DeepSeek Harness.
Works — verified, early-stage project
A plugin in the Developer category for DeepSeek Harness. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-plugin-github-search
Search before you build. A DeepSeek Harness plugin that
makes an agent check GitHub and npm for existing projects before writing a new plugin or capability —
so an existing project is found before time is spent reinventing it.
What it does
github_search— structured GitHub repository search (name, stars, description, language) sorted by
stars, via the GitHub Search API. By default thetopic:dsh-pluginqualifier is added; pass an explicittopic(or an empty string) to override.npm_search— structured npm package search, catching plugins published to the registry without a
GitHub topic. npm qualifiers likekeywords:dsh-pluginare supported.- System-prompt rule (
guidePrompt, default on): the agent MUST call these tools before writing a new
plugin or capability, report what exists, and only then decide to build fresh, borrow, or skip.
Try it
# optional: a GitHub token raises the anonymous search rate limit
$env:GH_TOKEN = "ghp_..." # Windows
export GH_TOKEN=ghp_... # macOS/Linux
# install the bundle into any profile (the prepare script builds on install)
dsh plugin --profile web add github:Tianbaidi/dsh-plugin-github-search
Then ask: "I want to build a dsh plugin that lets a text-only model read images — check GitHub first."
The agent searches, summarizes existing projects, and recommends build / borrow / skip.
Windows note: dev overlay plugin paths must be
file://URLs (file:///D:/...%20...).
Configuration
| Key | Default | Meaning |
|---|---|---|
ghTokenEnv |
GH_TOKEN |
Env var holding an optional GitHub token. |
defaultTopic |
dsh-plugin |
Topic qualifier appended when github_search.topic is omitted; empty disables. |
limit |
8 |
Default result count. |
guidePrompt |
true |
Install the "search before you build" system-prompt rule. |
Develop
pnpm install
pnpm typecheck
pnpm test # 10 vitest cases: URL building, response parsing, tool execution
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-plugin-github-search for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:Tianbaidi/dsh-plugin-github-searchHeadless (CLI) profile:
dsh plugin --profile headless add github:Tianbaidi/dsh-plugin-github-searchTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-plugin-github-search/)<a href="https://dshbase.com/plugins/dsh-plugin-github-search/"><img src="https://dshbase.com/badges/dsh-plugin-github-search.svg" alt="dshbase install-tested"></a>