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 the topic:dsh-plugin qualifier is added; pass an explicit topic (or an empty string) to override.
npm_search— structured npm package search, catching plugins published to the registry without a
GitHub topic. npm qualifiers like keywords:dsh-plugin are 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-searchThen 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 executionLicense
MIT