shjwudp/dsh-web-search-perplexity

Routes DSH's existing web_search tool to Perplexity's Agent or Search API, and adds a perplexity_research tool with depth levels, an optional image argument and a bundled research skill.

Registers a Perplexity backend into DSH's ctx.web seam, so the host's existing web_search tool is answered by Perplexity instead of the default provider and the agent's tool list never changes. By default queries hit Perplexity's Agent API and come back as a synthesized answer with sources; setting searchProvider to perplexity-search serves the same tool from the Search API with ranked hits plus domain, language, country, date and recency filters. The plugin also contributes perplexity_research, a second tool with its own 30-minute budget, depth values low, medium, high and wide, and an optional image argument taking an absolute local path or a public URL. A bundled perplexity-research skill tells the model when to search versus research, how to read a degraded result and how to cite. Configuration lives on the web-search-perplexity row in cordis.patch.yml or in Settings -> Built-in plugins -> Perplexity web search, covering preset, maxTokens, researchDepth, softTimeoutMs and imageInput.

Tools & Capabilities ★ 0
View on GitHub ↗

Install

dsh plugin --profile web add github:shjwudp/dsh-web-search-perplexity#v0.2.0-rc.1

Copied verbatim from the README's ## Install fenced bash block, which documents only the pinned tag. No npm package: the npm registry lookup (2026-10-17) recorded no entry for @shjwudp/dsh-web-search-perplexity, so the GitHub form is what ships.

Compatibility

Requires DSH 0.2.0-rc.2 or newer within 0.2.x — on 0.1.x this version's apply() fails and v0.1.7-rc.2 is the 0.1.x build — plus Node >= 18 and a profile with the ctx.web seam mounted, since the plugin injects web, tools and systemPrompt. It needs a Perplexity API key from PERPLEXITY_API_KEY or the settings card, and because the web profile ships with model-facing tools disabled, - id: tool-web, disabled: false must be added to the same patch. Restart DSH after installing; calls spend Perplexity API quota, and the research tool declares its own 30-minute budget.

Details

Alternatives

korosu/dsh-web-search-ddg · hjnvv00v/dsh-web-search-tavily-relay · elves-ai/dsh-web-search-firecrawl

More plugins in Tools & Capabilities

Browse more in Tools & Capabilities

Guides for Tools & Capabilities plugins