dsh-find-plugin

dsh-find-plugin

English | 中文

A plugin that finds plugins — think /find-skills from skills.sh, for DSH.

Tell your agent what you want ("notify me on WeChat when a task finishes"), and it searches the DSH plugin ecosystem on GitHub for you — top results by stars, each with a one-line description and an install command.

Install

Usage

Restart dsh web after installing, then just talk to the agent — it calls find_dsh_plugin on its own whenever plugin discovery helps: "What terminal TUI plugins are there?" "I want to get a WeChat notification when a task finishes — any plugin for that?" "Find me something for reviewing git diffs inside DSH."

Each result comes back with stars, a description, the repo link, and a ready-to-run dsh plugin add command — ask the agent to install one and it can run the command for you. How it works Live GitHub repository search scoped to the official dsh-plugin topic, re-ranked by stars (5-minute per-query cache). When a result is also listed on awesome-dsh-plugin, its hand-written bilingual description from plugins.json replaces the GitHub one (the lang parameter picks the language) — ranking is untouched. Every result comes with a ready-to-run dsh plugin add command. Plugins are third-party code — review the source and pin a commit. Rate limits and offline fallback

GitHub's search API allows only 10 requests/minute per public IP when unauthenticated, and that quota is shared by every host behind the same egress IP (carrier CGNAT, corporate NAT, …), so a search can fail with HTTP 403 for reasons outside your control. The plugin therefore: uses the GITHUB_TOKEN DSH credential when one is configured (30 req/min, account-scoped, immune to shared-IP exhaustion). Optional — without it the tool still works, just closer to the anonymous limit; retries a rate-limited (403/429) or failed request once, then degrades instead of failing: it falls back to keyword matches from the curated list and says so in the result note; caches the curated list on disk ($DSH_HOME/cache/dsh-find-plugin/) and revalidates it with If-None-Match / If-Modified-Since, so restarts and offline runs use the full ~3400-entry list instead of the small bundled snapshot. says *why* a request failed. Node reports every transport failure as a bare fetch failed and hides the useful part in cause, so the plugin surfaces the chain (fetch failed ← certificate has expired (CERT_HAS_EXPIRED)) and names the one trap that otherwise looks like a plugin bug: a system prox

DSH plugin APIs are prerelease-versioned, and node-semver only lets a prerelease satisfy a range that carries a prerelease on the *same* major.minor.patch — so a peer range pinned to one host line silently stops matching the next one. The declared @deepseek-ai/dsh-tools range therefore names every shipped line through 0.1.7, and npm run check:peers (run in CI) resolves the current latest/next host lines from the registry and fails the day a new one is not covered. Development

License

MIT © awesome-dsh-plugin