Skip to content

Coding agents

The @telemai/dsh-plugin package adds web search and page reading to DeepSeek Harness as native tools. Every agent preset sees them.

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

  1. Open your project
  2. API keys
  3. Issue API key

tlm_••••••••••••••••Keys start with tlm_.

Open the console

Never paste a key into a chat with DeepSeek Harness. Every path below sets it for you.

Connect DeepSeek Harness to Telem

DeepSeek Harness is not in the installer, so you add the plugin by hand.

  1. Add the plugin to your profile, and set your key. For the headless profile, run the first command again with --profile headless. The plugin reads the key from TELEM_API_KEY, from $DSH_HOME/.credentials.yaml, or from ~/.telem/credentials.json.

    Terminal window
    dsh plugin --profile web add @telemai/dsh-plugin
    export TELEM_API_KEY=... # your key (or run `npm create @telemai`)
  2. Check the install. The output lists a telem row.

    Terminal window
    dsh --profile web --dump-config

Search and read

2 tools
  • telem_search Searches the web on several providers in one call.
  • telem_fetch Reads the full text of up to 5 pages.
  • Make Telem the only web tool. DSH’s built-in web_search and web_fetch stay on. To turn them off:
    • Headless and TUI profiles: add - id: tool-web with disabled: true to the profile’s cordis.patch.yml. Disable the whole row: a patch replaces the row, so search: false alone would also reset fetch.
    • The web profile: copy the preset you use into $DSH_HOME/.agent-presets/, without the tool-web row.
  • 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.

Run each command once for each profile that you added the plugin to: web, headless, or both. To update:

Terminal window
dsh plugin --profile web add @telemai/dsh-plugin@latest

A plain update stays inside the version range saved when you installed, so use add …@latest. To remove it:

Terminal window
dsh plugin --profile web remove @telemai/dsh-plugin

Restart 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.

Configuration

Set the tier, the providers and auto-routing in one file, for DeepSeek Harness and your other agents.

Parameters

Every option, the values it takes, and which setting wins.

Search parameters

What each search option does, from tiers to date windows.

Fetch parameters

Choose the fetch provider and tier, or read pages live.

Was this page helpful?