@deepseek-ai/dsh-web-search-tavily

Readme

# dsh-web-search-tavily

Tavily-backed web search provider for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).

It registers a `tavily` provider on `ctx.web`, can replace the native `web_search` backend, and adds a **Settings → Plugins** card for:

- API key management (via DSH credentials)
- toggling whether Tavily replaces DeepSeek native search

## Install

```sh
dsh plugin --profile web add github:renchengxiang/dsh-web-search-tavily
```

Or with an HTTPS archive URL:

```sh
dsh plugin --profile web add https://github.com/renchengxiang/dsh-web-search-tavily/archive/refs/heads/main.tar.gz
```

Then **fully restart** DeepSeek Harness Desktop / `dsh web`.

### Install from tag

```sh
dsh plugin --profile web add https://github.com/renchengxiang/dsh-web-search-tavily/archive/refs/tags/v0.1.0.tar.gz
```

## Configure

1. Open **Settings → Plugins → Plugin configuration**
2. Expand **Tavily search**
3. Paste your Tavily API key
4. Keep **Replace native web search** enabled if you want `web_search` to use Tavily
5. Save

You can also export an environment variable / credential named `TAVILY_API_KEY`.

## What it changes

| Aspect | Effect |
| --- | --- |
| Tool name | Still native `web_search` |
| Backend | Switches to Tavily when enabled |
| Settings UI | Adds a Plugins card under namespace `tavily-search` |
| Persistence | Survives restart via profile bundle patch |

## Bundle patch

The package ships `cordis.patch.yml` through `dsh.bundle.patch`, so `dsh plugin add` mounts:

1. `web.searchProvider: tavily`
2. Host plugin row `web-search-tavily`

No manual `cordis.patch.yml` editing is required for a clean install.

If you previously mounted a local/dev copy manually, remove the old local mount lines first to avoid double registration.

## Development notes

- Host: `lib/index.js`
- Client settings card: `lib/client.js`
- Settings namespace / card key: `tavily-search`
- Provider id: `tavily`

## License

MIT