dsh-acp-for-bitfun: Let DeepSeek Harness Call BitFun Subagents via ACP

dsh-acp-for-bitfun is a DeepSeek Harness (DSH) plugin (DSH plugin) maintained by bobleer under the MIT license, designed to integrate BitFun into dsh as a subagent. It solves the problem of not being able to directly call BitFun capabilities within dsh sessions by using the Agent Client Protocol (ACP) v1 over stdio. Core capabilities include exposing the subagent_bitfun tool in dsh to delegate tasks to BitFun, with configurable permission policies, environment variables, and startup checks.

What core features does the dsh-acp-for-bitfun DSH plugin support?

The plugin reuses the official @deepseek-ai/dsh-subagent-acp as the ACP client. Each task delegation spawns a fresh bitfun acp subprocess, completing the initialize → session/new → session/prompt flow and streaming agent_message_chunk responses. The tool is mounted via @deepseek-ai/dsh-tool-subagent, and the model sees it as subagent_bitfun by default. On task completion, the plugin closes the subprocess stdin and terminates it with a 6-second EOF grace period, then SIGTERM, then SIGKILL, ensuring the BitFun subprocess exits immediately on SIGTERM while session data is persisted by BitFun itself.

How to install the dsh-acp-for-bitfun DSH plugin?

Before installation, ensure prerequisites are met: BitFun CLI is installed and bitfun acp doctor passes, dsh version is at least 0.1.0-rc.6, and pnpm is available. Then run the following command:

dsh plugin --profile web add github:bobleer/dsh-acp-for-bitfun

Alternatively, install from a local checkout:

dsh plugin --profile web add ./dsh-acp-for-bitfun

Start dsh:

dsh web

On load, the plugin probes BitFun CLI with bitfun --version; if it's not on PATH, startup fails loudly with a message prompting to install BitFun or configure an absolute path.

What configuration options does the dsh-acp-for-bitfun DSH plugin support?

Configuration is done in the profile's cordis.patch.yml by overriding by id. Key options include: command (BitFun CLI path, default bitfun), providerName (default bitfun), toolName (default subagent_bitfun), permission (default reject, can be allow), acpArgs (default ['acp']), env (extra environment variables), and checkOnStart (default true, probes on load). For example:

- id: bitfun-acp
  name: dsh-acp-for-bitfun
  config:
    command: /absolute/path/to/bitfun
    permission: allow

How to verify the dsh-acp-for-bitfun DSH plugin works correctly?

Verification steps include: 1) Run bitfun acp doctor on the BitFun side; 2) Confirm the plugin line in the dsh config tree using dsh --profile web --dump-config | grep -A 2 bitfun; 3) In a dsh session, ask the model to call the subagent_bitfun tool with a simple task (e.g., "use subagent_bitfun to reply hello") and confirm the output from BitFun is returned.

Which DeepSeek Harness versions and platforms are compatible with dsh-acp-for-bitfun?

The plugin requires BitFun version >= 0.2.17 (supporting ACP v1 server) and dsh version >= 0.1.0-rc.6. Since deepseek-harness is currently in developer preview, the plugin depends on its rc version; when upgrading dsh, upgrade this bundle accordingly. The plugin is maintained by bobleer under the MIT license and was last updated on 2026-08-13.

View more DSH plugins at dsh-plugin.org