dsh-acp-interactive

dsh-acp-interactive

English | 中文

Editor-facing Agent Client Protocol server over JSON-RPC stdio. It creates dsh agents on demand and projects their live session events into ACP message, thought, tool, permission, plan, title, usage, and command updates. Zed is the first compatibility target.

The package ships both the UI transport plugin and the dsh-acp-interactive executable. The transport contains no domain logic; the executable loads the complete Cordis composition bundled in config/cordis.yml — DeepSeek and user providers, the agent spine, model-generated session titles, file and filesystem-search tools, in-process subagents, shell, permissions, persistence, human commands, and the ACP transport — so ordinary users do not need a DeepSeek Harness source checkout. This UI bridge is separate from the upstream automation-only ACP transport.

dsh-acp-interactive is an independent, community-maintained project. It is not affiliated with or endorsed by DeepSeek or Zed Industries; it composes the published @deepseek-ai/dsh-* packages behind a reviewed editor profile and does not claim to be the official DeepSeek ACP agent. Quick start

--setup stores DEEPSEEK_API_KEY through the Harness credential store without echoing it. Then register the installed command in Zed's settings.json (open via Ctrl+Shift+P / Cmd+Shift+P and type zed: open settings); on Windows use the absolute path printed by where.exe dsh-acp-interactive (using forward slashes / or double backslashes \\), on macOS / Linux use which dsh-acp-interactive:

After saving, open Zed's Agent panel (Ctrl+? / Cmd+?) and select dsh-acp-interactive from the dropdown list at the top. JSONL sessions live under acp-sessions in the dsh home (see Configuration), partitioned by each session's cwd and independent of the directory the server was started from; set DSH_ACP_SESSIONS_ROOT to keep them elsewhere. Every server process owns a separate in-memory SQLite session-query index, so several editor processes can share the JSONL source of truth without contending for the derived index.

Skipping --setup is fine: a thread opened without a stored key shows a Configure DeepSeek API key action that runs the same flow (see Authentication); clients without terminal authentication receive its instructions as an agent-type method instead.

The published tarball already contains the built lib/; no build step runs at install time. Every published version corresponds to a vX.Y.Z tag and a GitHub Release whose assets include the tarball and its SHA-256 checksum, so an installation can be audited against the tagged source. Supported Zed versions and verification status are in the Zed compatibility matrix; this release uses the stable ACP v1 schema from SDK 1.4.0 as its baseline. In Zed

The / palette lists the human commands discovered from the composed Harness plugins; the permission and reasoning-effort selectors are ACP session configuration options backed by Harness permission presets and the selected model's advertised efforts.