querit-ai/querit-plugins
Official Querit search plugins for AI agent harnesses: pi-querit (Pi extension), dsh-querit (DeepSeek Harness web seam), opencode-querit (OpenCode plugin)
安装Install
dsh plugin --profile web add dsh-querit把 querit-ai/querit-plugins 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
querit-plugins
Official Querit search plugins for AI agent harnesses.
Querit delivers real-time, authoritative web search results and clean page content for LLM applications. Each plugin in this repository wires one agent harness to the Querit API (/v1/search + /v1/contents) so your agent can search the live web and fetch pages — with cited sources, domain/region/language/time-range filters, and output that is always treated as untrusted web data.
| Harness | Package | Install |
|---|---|---|
| Pi | pi-querit |
pi install npm:pi-querit |
| DeepSeek Harness | dsh-querit |
dsh plugin --profile web add dsh-querit |
| OpenCode | opencode-querit |
"plugin": ["opencode-querit"] |
How each plugin reads the API key and search defaults is covered in its own section below.
Get an API key
Sign up on Querit.ai to get an API key with 1,000 free API calls per month — no credit card required. The same key works for all three plugins.
pi-querit — Pi
A Pi extension that registers web_search and fetch_content as first-class tools. Your agent calls them automatically whenever an answer needs the live web.
Install
pi install npm:pi-querit
API key
Run the interactive setup wizard inside Pi once:
/querit-setup
The wizard validates the key, then lets you configure persistent search defaults (result count, time range, countries, languages, domain whitelist/blacklist) and an optional fixed-model auto-summary workflow. Everything except the API key can be skipped.
- Where the key lives:
~/.pi/agent/querit-search.json(respectsPI_CODING_AGENT_DIR), written with mode0600on POSIX. - CI / ephemeral alternative: set the
QUERIT_API_KEYenvironment variable. The environment variable takes precedence when both are present. - Never put the key in chat or logs: the extension masks key input and redacts the key from every error surface.
See the pi-querit README for the full tool reference.
dsh-querit — DeepSeek Harness
A provider package for the DeepSeek Harness ctx.web capability seam. It does not register the model-facing web_search tool; the agent preset does. By default, it reuses the official applyWebFetchTool helper to register web_fetch, and routes both tools through Querit-backed providers.
Install
dsh plugin --profile web add dsh-querit
Then wire it in the profile's cordis.patch.yml:
- insert:
- id: web-search-querit
name: 'dsh-querit'
config:
apiKeyEnv: QUERIT_API_KEY
- id: web
config:
searchProvider: querit
fetchProvider: querit
API key — resolved per operation in priority order:
QUERIT_API_KEYexported in the launching environment, or- the credentials store
$DSH_HOME/.credentials.yaml(QUERIT_API_KEY: <key>, hot-reloaded), or - a literal
apiKeyon theweb-search-queritrow (least preferred — secrets should not live in composition files).
Search defaults (count, timeRange, countries, languages, includeDomains, excludeDomains, includeContent, chunksPerDoc, fetch format/timeouts) are configured on the plugin row or in the hot-reloaded $DSH_HOME/settings.yaml web-search-querit: section.
See the dsh-querit README for the full config table.
opencode-querit — OpenCode
An OpenCode plugin that registers web_search and web_fetch as custom tools next to the built-ins. Additive: OpenCode's own websearch/webfetch stay available.
Install
Add the plugin to opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-querit"]
}
Then restart OpenCode.
API key — resolved per tool call in priority order:
QUERIT_API_KEYenvironment variable (default; rename viaapiKeyEnv), orapiKeyin the plugin options tuple (least preferred — secrets should not live in config files):
{
"$schema": "https://opencode.ai/config.json",
"plugin": [
["opencode-querit", { "count": 8, "timeRange": "m3", "languages": ["english"] }]
]
}
Search defaults and fetch behavior are configured the same way (count, timeRange, countries, languages, includeDomains, excludeDomains, includeContent, chunksPerDoc, fetchFormat, fetchCrawlTimeout, fetchMaxChars, maxOutputChars).
See the opencode-querit README for the full config table and local-testing instructions.
Repository layout
Each directory is an independent npm package with its own version, CI, and
release cycle. There is no root workspace: the three harnesses have entirely
different dependency trees, so each package keeps its own package.json,
lockfile, and node_modules.
querit-plugins/
├── pi-querit/ # Pi extension (TypeScript, no build step)
├── dsh-querit/ # DeepSeek Harness provider package (compiled lib/ committed)
└── opencode-querit # OpenCode plugin (compiled lib/ committed)
Development
Work inside a package directory; the root has no scripts:
cd pi-querit && npm ci && npm run check && npm test
cd dsh-querit && npm ci && npm run check && npm run build && npm test
cd opencode-querit && npm ci && npm run check && npm run build && npm test
Publishing is per package. From that package's directory, run
npm version <version> --no-git-tag-version so package.json and
package-lock.json stay in sync, then verify and run npm publish. Releases
are tagged on GitHub with the package name prefix, e.g. pi-querit@<version>.
License
MIT — see each package's LICENSE file.
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…