dsh-http-tools

HTTP / API debugging tools for DeepSeek Harness (DSH).

dsh-http-tools gives your DeepSeek Harness agent a complete REST client: send any request with full control over method, headers, body, and auth, paste a curl command and let the agent run or tweak it, and review or compare past requests — all inside the chat.

Comes with an optional UI companion package (dsh-http-tools-ui) that renders every http_request / curl_parse call as a DeepSeek-branded card in the web UI.

Features

• http_request — full REST client: GET/POST/PUT/PATCH/DELETE/HEAD, custom headers, body, basic/bearer auth. Returns status, duration, size, response headers, truncated body, and an equivalent redacted curl command.
• curl_parse — parse a curl command into structured parts, or execute it in one step (execute: true).
• request_history — query in-session requests, inspect one, or diff two responses.
• Pagination-aware — the Link response header is surfaced to the model, so it can follow rel="next" / rel="last" without re-reading raw headers.
• Preview-slimmed logging — persisted session logs carry a 6000-char body preview, so logs stay readable as request volume grows.
• DeepSeek-branded UI cards (with dsh-http-tools-ui) — fish logo, brand-colored method badge, official state dot (running chase animation), theme-aware colors, collapsible JSON body (JsonTree), and copy-body / copy-curl buttons.

Tools

Tool	Description
http_request	Send an HTTP request (GET/POST/PUT/PATCH/DELETE/HEAD) with custom headers, body, and auth. Returns status, duration, size, response headers, truncated body, and an equivalent curl command.
curl_parse	Parse a curl command into its structured parts (method, URL, headers, body, auth). Optionally execute it in one step with execute: true.
request_history	Query requests made in the current session, inspect one in detail, or compare two responses side by side.

Install

dsh plugin --profile web add dsh-http-tools
# optional: DeepSeek-branded UI cards for the web client
dsh plugin --profile web add dsh-http-tools-ui

Works out of the box with zero configuration. Node.js >= 22 is required (uses the native fetch).

UI cards

dsh-http-tools-ui is a separate package that registers keyed tool views for http_request and curl_parse. Once installed, each call renders as a card in the conversation:

• Fish logo + brand-colored method badge (GET / POST / …)
• Official state dot: green on success, amber on non-2xx, red on error, animated chase while running
• Status · duration · size · truncated summary on the row head
• Expandable response: key headers inline, JSON body as a collapsible tree (with copy actions), non-JSON bodies as text
• Copy / Copy curl buttons, all colors theme-aware (--dsw-* tokens)

Try it

Tell your agent things like:

用 http_request 调 https://api.github.com/repos/deepseek-ai/deepseek-harness 看看 star 数

POST https://httpbin.org/post，body 传 {"hello":"world"}，看看返回什么

粘贴这个 curl 命令解析一下，然后改个 header 再重发：
curl -X POST https://api.example.com/v1/users -H "Content-Type: application/json" -d '{"name":"ada"}'

用 request_history 对比 #1 和 #3 两次请求的响应差异

Configuration

All options are optional. Set them in your profile's cordis.patch.yml:

…