DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-plugin-microvm

y

dsh-plugin-microvm

Discovered

Disposable microVM sandbox tools for DeepSeek Harness agents: create, exec, fork, destroy via any E2B-compatible API (E2B, AgentENV)

dsh-plugin-microvm

Disposable microVM sandboxes for DeepSeek Harness agents.

The plugin gives a DSH agent seven tools that run commands, edit files and fork in Firecracker-class microVMs through any E2B-compatible API: E2B cloud, self-hosted E2B, or AgentENV. Use it when the agent should try untrusted code, install packages, or explore several fixes in parallel without touching your machine.

you> clone the repo, install deps, then try 3 different fixes for the failing test in parallel

agent  microvm_create        → sb_a1 (template base)
agent  microvm_exec   sb_a1  git clone … && pip install -e .        [exit 0]
agent  microvm_fork   sb_a1  count=3 → sb_b1 sb_b2 sb_b3            (memory + disk cloned)
agent  microvm_exec   sb_b1  apply fix A && pytest -x               [exit 1]
agent  microvm_exec   sb_b2  apply fix B && pytest -x               [exit 0]  ✓
…

No runtime dependencies, plain ESM: it installs straight from GitHub without a build step or allowBuilds permission.

Install

dsh plugin --profile web add github:yingmsky/dsh-plugin-microvm
export E2B_API_KEY=e2b_...        # or set apiKey in config
dsh web

Pin a commit for anything you rely on: github:yingmsky/dsh-plugin-microvm#<sha>.

Tools

ToolWhat it does
microvm_createStart a sandbox from a template; returns sandboxId
microvm_execRun bash -l -c <command> and wait: exit code, stdout, stderr (head + tail kept when long), timeout kills the process
microvm_read_fileRead a text file (capped)
microvm_write_fileWrite a text file, creating parent dirs
microvm_forkClone a running sandbox, memory and disk, into N copies
microvm_destroyKill a sandbox now
microvm_listLive sandboxes in this session, with labels and fork lineage

Every tool returns a typed canonical value (DSH output.schema), so in PTC mode await tools.microvm_exec({...}) gives you { exitCode, stdout, stderr, timedOut, … } directly. microvm_exec renders as a terminal card.

Configure

Defaults work for E2B cloud. Override in your profile's cordis.patch.yml; a patch replaces the row's whole config, so restate every key you set:

- id: microvm
  config:
    template: base
    sandboxTimeoutSec: 600
    maxSandboxesPerAgent: 4

AgentENV (self-hosted)

- id: microvm
  config:
    apiKey: unused                     # AgentENV has no auth yet; keep it on localhost
    apiUrl: http://127.0.0.1:8000
    envdUrl: http://127.0.0.1:8000     # adjust to how your AgentENV deployment exposes envd
    template: <your template>

autoPause is always sent explicitly (default false). AgentENV defaults it to true, unlike E2B, so without this an idle sandbox is paused rather than killed at its TTL and lingers.

KeyDefaultNotes
apiKey$E2B_API_KEYSent as X-API-Key
apiUrl$E2B_API_URL or https://api.<domain>Control plane
domaine2b.app ($E2B_DOMAIN)Used when the API response names no domain
envdUrlhttps://{port}-{sandboxId}.{domain}envd base URL template
envdPort49983
useruserSandbox user for commands and files; empty = envd default
templatebaseDefault template for microvm_create
sandboxTimeoutSec600Idle TTL, refreshed on every use
autoPausefalsePause instead of kill at TTL
allowInternetAccesstrue
execTimeoutMs / maxExecTimeoutMs120000 / 600000Per-command timeout and the cap the model may request
maxOutputBytes32768Per stream, head + tail
maxReadBytes262144
maxSandboxesPerAgent4Counts forks
maxForkCount8Per microvm_fork call (max 16)
enableForktrueHide microvm_fork for backends without it
keepOnDisposefalseLeave sandboxes running when the plugin unloads
requestTimeoutMs60000Control-plane and file calls

Lifecycle and safety

  • Scoped ids. The model can only address sandboxes this plugin instance created. Any other id on the same account is rejected, even if the model guesses it.
  • No leaks. Each sandbox has a server-side TTL refreshed on use. A sandbox is destroyed when the agent that created it is disposed (agent/disposed) and when the plugin unloads or hot-reloads.
  • Bounded. Per-agent sandbox cap, fork cap, per-command timeout with a hard ceiling, output and read caps.
  • No orphan processes. A command that times out or is cancelled is sent SIGKILL over envd, not just disconnected.
  • Tools, not confinement. This adds sandbox tools. It doesn't move DSH's built-in bash / file tools into the VM, so use DSH's permission presets if the agent shouldn't also run things locally.

How it works

Two planes, both spoken directly with fetch (no SDK):

  • Control plane: POST /v2/sandboxes, POST /sandboxes/{id}/fork, POST /sandboxes/{id}/timeout, DELETE /sandboxes/{id}.
  • envd (the in-VM agent): process.Process/Start as a Connect server stream (application/connect+json, 5-byte envelopes; base64 stdout/stderr frames; proto3 JSON omits exitCode when it's 0), process.Process/SendSignal for kills, and GET/POST /files for file I/O.

Wire details follow the E2B JS SDK and spec/envd/*.proto in e2b-dev/E2B.

Development

npm test                                   # 21 tests against a mock E2B server whose envd really runs bash
dsh plugin --profile dev add "$PWD"         # link the checkout into a profile
node test/e2e/run.mjs dev                   # boot real DSH, drive every registered tool

CI runs the unit tests on Node 22 and 24, then boots a real @deepseek-ai/dsh with the plugin installed. A probe plugin there calls the tool definitions DSH built, so DSH's own argument validation runs, and each result is checked against the compiled output schema and renderer. CI also installs the plugin via dsh plugin add github:….

Status

v0.1, against DSH 0.2.x (developer preview, which warns of breaking changes). Verified in CI on DSH 0.2.2 (installed from npm and from GitHub) against a mock E2B server. Not yet run against live E2B or AgentENV: reports welcome. The envd routing of self-hosted AgentENV in particular may need a different envdUrl.

License

MIT

Comments

Loading…

Similar plugins

dsh-agentenv-sandbox

by ztting01

AgentENV/E2B microVM execution-world bundle for DeepSeek Harness

Manifest valid

★ 0

MIT

TypeScript

Aug 29, 2026

dsh plugin --profile web add dsh-agentenv-sandbox

by Kevinwu901113

Give DeepSeek Harness its own persistent computer: a bundled microVM with shell, browser, live view and approval gates

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 17, 2026

dsh plugin --profile web add dsh-computer

by HakureiMonika

Agent-native browser DevTools workbench for DeepSeek Harness. / 让你的DSH获得非常强大的 Chromium DevTools 能力

Tools & CapabilitiesManifest valid

★ 10

↓ 29/wk

MIT

TypeScript

Sep 28, 2026

dsh plugin --profile web add dsh-browser-scope

by frozo-ai

Remote execution worlds for DeepSeek Harness: run the agent's Bash, terminals, LSP and file tools inside a container. Zero dependencies.

Development & InfrastructureManifest valid

★ 3

JavaScript

Aug 18, 2026

dsh plugin --profile web add dsh-worlds

by staff-os

An enterprise workbench for the DeepSeek Harness: AI employees, knowledge bases, skills, MCP servers and DSH plugins, all manageable from a running session.

Development & InfrastructureManifest valid

★ 4

MIT

JavaScript

Aug 25, 2026

dsh plugin --profile web add @staff-os/dsh-workbench

by elementor-i

agentmemory for DeepSeek Harness (dsh): full memory_* tools, capture hooks, and context injection over the local REST server

Tools & CapabilitiesSessions & MessagesManifest valid

★ 4

↓ 24/wk

MIT

TypeScript

Aug 17, 2026

dsh plugin --profile web add @elementor-i/dsh-agentmemory