dsh-find-plugin

Finding and installing DSH plugins used to mean leaving the agent, manually searching GitHub and the awesome list, then copying an install command. On top of that, the upstream tool calls the GitHub search API anonymously at a shared 10 requests/minute per public IP cap, meaning even the first call in a session can hit a 403. dsh-find-plugin is a maintenance fork of upstream 0.3.7 that moves the entire search-and-install workflow inside the agent conversation.

Three pillars differentiate this fork. First, dual-source merging: it queries both the GitHub dsh-plugin topic (ranked by stars) and the curated list of roughly 3400 bilingual entries, deduplicates, and fills the remaining slots so the user always gets the requested number of results. Second, a real degradation chain: when GitHub is unreachable, results fall back to curated keyword matches, then to an in-memory cache, a disk cache, and finally a bundled snapshot, ensuring offline availability. Third, engineering hardening: with a GITHUB_TOKEN the rate limit rises to 30 requests/minute with no shared-IP interference; registry fetches use If-None-Match conditional requests so a 304 response transfers zero body bytes; and rate-limit or network errors return structured fields (limit, remaining, resetAt) instead of throwing bare exceptions.

This plugin is designed for developers who install DSH plugins frequently or operate behind a shared egress IP. Users who prefer Chinese descriptions can set the lang parameter to zh. It ships with zero third-party dependencies and works with a simple natural-language query inside the agent session.