Coding agents
DeepSeek Harness
The @telemai/dsh-plugin package adds web search and page reading to
DeepSeek Harness as native tools. Every agent
preset sees them.
Before you begin
Section titled “Before you begin”pnpm on your PATH, and the DSH profile that you use (web or headless) set up.
dsh plugin installs into a profile through pnpm.
Create a Telem API key
- Open your project
- API keys
- Issue API key
tlm_••••••••••••••••Keys start with tlm_.
Never paste a key into a chat with DeepSeek Harness. Every path below sets it for you.
Install
Section titled “Install”Connect DeepSeek Harness to Telem
DeepSeek Harness is not in the installer, so you add the plugin by hand.
-
Add the plugin to your profile, and set your key. For the
headlessprofile, run the first command again with--profile headless. The plugin reads the key fromTELEM_API_KEY, from$DSH_HOME/.credentials.yaml, or from~/.telem/credentials.json.Terminal window dsh plugin --profile web add @telemai/dsh-pluginexport TELEM_API_KEY=... # your key (or run `npm create @telemai`) -
Check the install. The output lists a
telemrow.Terminal window dsh --profile web --dump-config
Search and read
2 toolstelem_searchSearches the web on several providers in one call.telem_fetchReads the full text of up to 5 pages.
Specific to DeepSeek Harness
Section titled “Specific to DeepSeek Harness”- Make Telem the only web tool. DSH’s built-in
web_searchandweb_fetchstay on. To turn them off:- Headless and TUI profiles: add
- id: tool-webwithdisabled: trueto the profile’scordis.patch.yml. Disable the whole row: a patch replaces the row, sosearch: falsealone would also resetfetch. - The web profile: copy the preset you use into
$DSH_HOME/.agent-presets/, without thetool-webrow.
- Headless and TUI profiles: add
- Subagents. In-process subagents (spawn and fork) get the Telem tools, and their
searches are linked to the parent as it was when they started. Out-of-process
backends (
subagent-acp,subagent-claude-code,subagent-codex,subagent-dsh-sdk) get no Telem tools. - The session id stays out of the chat. The plugin shows the Telem session id in DSH’s session log and UI, not to the model.
- Big page reads go to a file. A full batch of 5 pages is larger than DSH’s default inline limit, so DSH saves the result to a file with a preview, and the model reads the file.
Update and remove
Section titled “Update and remove”Run each command once for each profile that you added the plugin to: web,
headless, or both. To update:
dsh plugin --profile web add @telemai/dsh-plugin@latestA plain update stays inside the version range saved when you installed, so use
add …@latest. To remove it:
dsh plugin --profile web remove @telemai/dsh-pluginRestart dsh web afterwards. A headless run starts fresh each time. If you added a
- id: telem row to cordis.patch.yml, delete it.
Your key stays where you set it: TELEM_API_KEY, $DSH_HOME/.credentials.yaml or
~/.telem/credentials.json. The plugin never writes it to cordis.patch.yml.
Learn more
Section titled “Learn more”Set the tier, the providers and auto-routing in one file, for DeepSeek Harness and your other agents.
Every option, the values it takes, and which setting wins.
What each search option does, from tiers to date windows.
Choose the fetch provider and tier, or read pages live.