Introduction

DeepSeek Harness (DSH) supports parallel execution of multiple agents. Once the formation is running, it often involves dealing with multiple session streams, shared to-dos, real-time tool calls by sub-agents, and conflict risks arising from overlapping write domains. Relying solely on the native session list and pop-ups makes it difficult to answer “who is doing what, where is the task stuck, and do we need to intervene?” within a single screen.

Cockpit (dsh-cockpit) consolidates formation status, task boards, real-time streams, and write operations into a single real-time dashboard, allowing approvals, messaging, and interruptions to be handled within the same interface. Starting from v0.2, it can be embedded in the DSH workbench sidebar while retaining a standalone URL for access via a secondary screen or mobile phone. This plugin is released by community maintainer zoe1nan and categorized under “Workflow” in the SkillHub directory. The source code is hosted on GitHub under the MIT License and has no official affiliation with DeepSeek or High-Flyer.

What is this

In one sentence: A Live command deck for DSH agent formations—to see clearly what the formation is doing and make decisions in the same place.

It solves the “observability and controllability during multi-agent parallel execution” problem: member rosters, task dependencies, tool call streams, current token usage and progress, as well as write operations like approval gates, message queues/interjections, and turn interruptions are all centralized in the /cockpit/ interface (or the embedded main area of the workbench). Data is local-first by default: the plugin listens on the local DSH port and does not report to external servers; aside from operations triggered by your clicks, it does not automatically modify tasks or approve requests.

Core Features

Summarized below based on the v1.2 features in the README; only capabilities explicitly documented in the materials are listed.

View: Formation, Task Board, and Real-time Stream

  • Real-time Formation: Displays each member’s model, actual token count, current action, and scope of responsibility (inferred from task topics/modified files); grouped by Running / Idle / Exception, with running ones listed first.
  • Task Board: Shared tasks, status columns, dependencies (blockedBy); overlapping write domains between two agents are marked as “Double-write risk”.
  • Plan Fallback: When there is no shared task board, the current round’s to-do plan is used to populate the task board to avoid emptiness.
  • Real-time Stream: Tool calls are displayed in plain language (e.g., “Run command”, “Edit file”, “Search content”); parameters are collapsed into a single line by default but can be expanded; since v1.2, consecutive calls of the same type are collapsed into “×N”.
  • Current Round Data: Progress, tokens, duration, steps, model, status; liquid progress bars update with events.
  • Session Switching: Switch sessions via the left column or top pills; the “Copy link” button in the top bar allows sharing the current session view (v1.1).
  • Self-check and Diagnostics: The settings page allows one-click checking of the plugin, status data, real-time stream, capsule, HUD data bridge, remote access, pending approvals, host interface, etc., and allows copying the full report (v1.1).

Operations: Approve, Message, Interrupt

  • Approval Gate: Approval requests appear in the command deck, allowing “Allow once” or “Deny”; if not handled within 25 seconds, they fall back to the native DSH pop-up. Can be disabled by setting the environment variable DSH_COCKPIT_APPROVALS=0.
  • Send Message: Queue messages for delivery to a specific agent, or “Insert” to interrupt the current turn and speak immediately.
  • Interrupt: Stop the currently running turn after inline confirmation.
  • Write Operation Safety: Same-origin validation, rollback on failure, and local audit logs at ~/.dsh/cockpit/audit.jsonl.

Desktop Capsule (Windows Only)

Windows 10 2004+ users get a desktop floating capsule after installing the plugin: liquid progress bar, step count, “N running · M batch” badge; clicking opens the command deck (directly jumping to the approval area if there are pending approvals). The capsule follows any running session (following the most recently active one in multi-session scenarios, returning to “Standby” when idle). The process is managed by the plugin (auto-start/stop and crash restart), and can be toggled on the settings page. macOS / Linux only support the command deck; the capsule is hidden automatically.

Mobile and Remote

Disabled by default. When enabled, it supports LAN 6-digit one-time pairing codes (valid for 2 minutes, single-use, rate-limited on errors); if HTTPS is required, a tunnel wizard is provided (detects cloudflared / Tailscale and only provides commands). Public HTTPS, Secure Cookies, and revocation of paired devices are supported; system notifications can be sent when approvals arrive while the page is in the background; PWA installation and offline shells are supported. Remote-related environment variables include DSH_COCKPIT_REMOTE_PORT (default 6688), DSH_COCKPIT_REMOTE_SECURE=1, etc.

Interface and Extensions

Three layouts available: embedded workbench, standalone page, and mobile single-column; column widths are draggable and reset by double-clicking; dark mode follows the workbench; adapts to three widths: 1250 / 1000 / 390. Other DSH plugins can register read-only JSON extension cards (list / metrics / status / text) via ctx.cockpit.registerCard, with actions handled via the same-origin POST /cockpit/api/cards/<id>/action; the contract is detailed in docs/STATE.md in the repository.

Installation and Activation

Prerequisites: DeepSeek Harness installed with the plugin system and client modules, Node.js ≥ 22. Desktop capsule requires Windows 10 2004+.

  1. Download dsh-cockpit-<version>.tgz from Releases (the README example uses version 1.2.2).
  2. Install to the specified profile and restart DSH:
dsh plugin --profile <profile> add /path/to/dsh-cockpit-1.2.2.tgz
  1. After restart, “Cockpit Command Deck” appears in the sidebar; click to open and use in the main area; on Windows, the desktop capsule starts automatically with the host.

Standalone access URL: http://127.0.0.1:<DSH Port>/cockpit/.

Upgrade: Repeat add with the new tgz and restart; settings and aliases are stored in ~/.dsh/cockpit/ and will not be lost during upgrade. Uninstall:

dsh plugin --profile <profile> remove dsh-cockpit

Then restart DSH.

Typical Usage

Daily Formation Monitoring

Enter Cockpit via the sidebar, select a session in the left column or switch via top pills. View the task board and write domain conflict warnings in the middle, and expand tool parameters in the real-time stream on the right. When intercepting approvals, click allow/deny within the panel to avoid relying solely on system pop-ups.

Interjecting or Interrupting a Specific Agent

Send a queued message to the target agent in the command deck, or select “Insert” to interrupt the current turn; after confirmation, use the inline interrupt to stop the executing turn.

Second Screen or Mobile

Open http://127.0.0.1:<DSH Port>/cockpit/ on a local secondary monitor; enable remote access in settings on mobile and connect using a pairing code (configure HTTPS via the wizard for public network scenarios). Copying the link from the top bar sends the current session view to colleagues, who will land on the same session when opening it (v1.1).

Plugin Authors Registering Extension Cards

Inject cockpit in your own plugin and call registerCard; refer to the README for example structures (e.g., git-status card); refer to examples/git-card in the repository.

Local development preview (not dependent on installed DSH):

npm run preview

Default: http://127.0.0.1:6077/cockpit/ (mock data).

Use Cases and Notes

Who it is for: Users who frequently run multi-agent formations with DSH, need task boards and write domain risk warnings, and want to batch approve and send messages in the same interface; Windows users benefit from the desktop capsule.

Permissions and Security: The plugin runs with the current DSH process permissions. Please read the source code and MIT License before installation to ensure that behaviors such as remote access and approval taking-over comply with your environment policies. Remote access is off by default, and approvals fall back to the native pop-up after 25 seconds; PWA and system notifications require a secure context (HTTPS or localhost). Known limitations include: Background Web Push is not implemented; teammates within the same session cannot be deleted, handled by collapsible groups in the UI.

Ecosystem Notes: The DSH community plugin directory (e.g., dsh-cockpit page on SkillHub) is an independent site with no affiliation to the official entity; star counts and other data are based on what you see on the GitHub page when you visit (directory clues suggest 24 stars).

Conclusion

dsh-cockpit places “what the formation is doing” and “whether to take action right now” on the same command deck: embedded workbench or standalone /cockpit/, task board and real-time stream, approval and write operation audits, plus Windows capsule and optional remote access. If you are already using DSH multi-agent workflows, you can install and try it via the official dsh plugin add path using the tgz from Releases.

  • Directory Page: https://www.skillhub.cn/plugins/zoe1nan/dsh-cockpit
  • GitHub: https://github.com/zoe1nan/dsh-cockpit