Skip to content
  • Home
  • Plugin manual
  • pi2dsh

weijiafu14/pi2dsh

131Last commit Aug 16, 2026

pi2dsh DSH plugin

pi2dsh implements Pi's public extension ABI on top of DSH's native services, allowing any Pi package to be installed as a DSH plugin. It acts as a bridge, enabling capabilities like vision, web search, memory, subagents, and more from the Pi ecosystem on DSH. The bridge is designed to be temporary; DSH's own ecosystem will eventually offer native alternatives.

developer-toolsremote-execution

How to install the pi2dsh DSH plugin

dsh plugin add pi2dsh          # once

Copying does not run this command. Review the repository and version before installing the pi2dsh DSH plugin.

pi2dsh DSH plugin data source

pi2dsh DSH plugin snapshot date: Aug 16, 2026

discovered

What the pi2dsh DSH plugin can do

  • Install any Pi plugin as a DSH plugin with the standard `dsh plugin add` command.
  • Run Pi plugins unmodified, no fork, patch, or per-package adapter needed.
  • Provides a vision bridge to give text-only models image analysis capabilities via Pi vision plugins.
  • Supports a wide range of Pi plugins: web search, memory, subagents, code navigation, approvals, side conversations, MCP adapters, and more.
  • Automatic image-admission companion routes for text-only models in the web UI.
  • Offers a `npx pi2dsh inspect` command to check a plugin before upgrading.

Where the pi2dsh DSH plugin fits

  • Enable image analysis in a text-only DeepSeek model by installing a Pi vision plugin and configuring a vision model endpoint.
  • Run side conversations with `/btw` commands using pi-btw, creating child sessions within DSH.
  • Persist cross-session memory with pi-hermes-memory, writing and reading memory across separate DSH processes.
  • Add a second-model approval gate for all tool calls using pi-approval-guardian, enhancing security.
  • Connect MCP tools via pi-mcp-adapter or pi-mcp-extension to extend DSH's capabilities.

Who the pi2dsh DSH plugin is for

  • DeepSeek Harness users who want to leverage the mature Pi plugin ecosystem.
  • Developers working with DSH who need capabilities like vision, search, memory, or subagents not yet available natively.

pi2dsh DSH plugin limitations

  • Requires Node.js 22.19+ and an existing DeepSeek Harness installation.
  • Pi plugins may need environment variables for configuration (e.g., vision model API key), which must be set manually by the user.
  • The bridge is a temporary solution; DSH's own ecosystem will eventually offer native alternatives, and users should switch when available.
  • Not all Pi plugins are fully verified; only a subset of the top 50 have been exercised end-to-end. Some features may require ABI gaps to be closed.
  • Installation can be affected by pnpm's default behaviors (blocked build scripts, minimum release age), requiring manual intervention.

pi2dsh DSH plugin: from the repository README

Quoted from the weijiafu14/pi2dsh README, the upstream source of the pi2dsh DSH plugin. Copyright remains with the original authors.

**English** | [中文](README.zh.md) **Run the Pi ecosystem's plugins on DeepSeek Harness, unmodified.** ```sh dsh plugin add pi2dsh # once dsh plugin add <any-pi-plugin> # then any Pi plugin, straight from npm ``` ## Why this exists [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) is built on ideas worth betting on — a durable, reconstructable session log, a clean service composition, an agent loop you can actually reason about. What it does not have yet is a large plugin ecosystem: it is early, and the plugins people want on day one — web search, memory, code navigation, subagents, vision — are mostly not written for it yet. [Pi](https://pi.dev/) has that ecosystem already, and it is mature: hundreds of published packages, many with real users. pi2dsh is one compatibility layer that implements Pi's public extension ABI on top of DSH's native services, so a Pi package runs on DSH **as published** — no fork, no patch, no per-package adapter. You install a Pi plugin the same way you install anything else in DSH, and it works. This is deliberately a bridge, not a destination. Every capability you reach through pi2dsh is a capability DSH's own ecosystem

Read the full READMERepository license: MIT

pi2dsh DSH plugin questions

How do I install pi2dsh?

Run `dsh plugin --profile web add pi2dsh` to install the engine. After installation, restart `dsh` to mount the plugin. You can then add any Pi plugin using `dsh plugin add <package-name>`.

Can I use any Pi plugin with pi2dsh?

In theory, any Pi plugin that follows the public extension ABI should work. However, only a subset of the top 50 most-downloaded packages have been tested. The README includes a verified list; for plugins outside that list, you may encounter ABI gaps that need to be fixed.

How do I configure a vision model for pi2dsh?

Set the environment variables `VISION_BRIDGE_BASE_URL`, `VISION_BRIDGE_MODEL`, and `VISION_BRIDGE_API_KEY` to point to an OpenAI-compatible vision endpoint. The plugin reads these at runtime. You can also add the model to DSH's own model picker via `settings.yaml`.

Why does my plugin not work after install?

Common issues include pnpm's `ERR_PNPM_IGNORED_BUILDS` error, which requires you to approve build scripts via `pnpm approve-builds` or edit `pnpm-workspace.yaml`. Also, pnpm's `minimumReleaseAge` may temporarily pin an older version; use `dsh plugin add <package>@<version>` to force a specific version.

Is pi2dsh a permanent solution?

No, pi2dsh is explicitly a bridge. The README states that DSH's own ecosystem will eventually offer native alternatives for capabilities you access through this bridge. You should switch to native plugins when they become available, as the bridge is designed to be temporary.