dsh-nanobot-subagent-link

dsh-tool-nanobot · NanoBot Subagent Bridge

Run the local nanobot AI agent as a subagent from DeepSeek Harness (DSH).

Registers a nanobot_run tool: DSH hands one self-contained subtask to nanobot, which executes it with its own tools and context and returns only its final answer. The plugin also registers a nanobot-run runtime skill and a prompt section, so fresh conversations discover the capability.

Install

dsh plugin --profile web add dsh-tool-nanobot

Restart dsh web, then use it. Requires dsh >= 0.1.0-rc.7 (verified on the 0.2.x line, including 0.2.1-rc.3) and a local nanobot CLI on PATH.

Usage

DSH calls nanobot_run automatically. Two invocation modes:

• oneshot (default) — runs nanobot agent -m <prompt> as an independent process per task (stateless, safest for unrelated tasks).
• server — calls a persistent nanobot serve OpenAI-compatible endpoint (/v1/chat/completions); faster, and auto-started when not already running.

Configuration (persisted in DSH Settings)

Namespace nanobot under Settings:

Field	Default	Description
mode	oneshot	Default invocation mode: oneshot / server
oneshotCommand	nanobot agent -m "{prompt}" --no-markdown	oneshot command template; must contain exactly one {prompt} placeholder
serverBaseUrl	http://localhost:8900	server-mode address (loopback only)
serverStartCommand	nanobot serve	command used to start the server
serverModel	(empty)	model to send; empty omits it so the server uses its own configured model

Security

• The command template and base URL come only from trusted user settings — there is no model-controllable command/URL injection surface.
• server mode enforces a loopback whitelist; the API key is never sent off-host.
• Sandbox-aware execution with approval-gated escalation (sandbox_permissions + justification).
• Output is truncated, and a started server process is terminated when the plugin tears down.

Requirements

• DeepSeek Harness dsh >= 0.1.0-rc.7 (verified on 0.2.1-rc.3; the plugin declares dsh.engines.dsh and host peers for both the 0.1.0 and 0.2.x release lines)
• A local nanobot CLI (e.g. uv tool install nanobot-ai)
• Windows: PowerShell, used by the shell service

Development

git clone https://github.com/2025Bigeye/dsh-nanobot-subagent-link.git
cd dsh-nanobot-subagent-link
npm install

Changelog

See CHANGELOG.md.

License

MIT