DeepSeek Harness Plugin

OpenPetsHQ/openpets#dsh

Stars ★ 1373 Downloads (30d) 897 Category Notifications & Integrations Added 2026-08-17 npm @open-pets/dsh

Bridges DeepSeek Harness lifecycle status, errors, and approval requests to a locally running OpenPets desktop companion.

Install

# from npm (prebuilt)

dsh plugin --profile web add @open-pets/dsh

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:OpenPetsHQ/openpets#path:/packages/dsh

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

Cordis plugin connecting the DeepSeek Harness (DSH) agent runtime directly to the OpenPets desktop companion.

Features

  • Lifecycle Reactions: Synchronizes DSH agent status (running ⇄ idle), errors, and approval requests with companion emotions.
  • Status Stream Awareness: Extracts ⏵ status lines from assistant stream chunks and displays them in companion speech bubbles.
  • Tool Operation Reactions: Maps bash executions (running), edit/write operations (editing), and read operations (working).
  • Toggleable Configuration: Enable or disable per profile or dynamically via Cordis plugin configuration.
  • Safe & Fail-safe: Automatically sanitizes paths and messages, strips URLs/secrets, throttles speech rate, and isolates IPC failures so the agent loop never stalls.

Installation

Add to your DSH profile or user configuration (~/.dsh/cordis.patch.yml):

- insert:
    - id: plugin-openpets-dsh
      name: '@open-pets/dsh'
      disabled: false
      config:
        enabled: true
        minSpeechIntervalMs: 1200
        enableStatusLineStream: true
        enableToolEvents: true
        enableApprovalEvents: true

Configuration Options

Option Type Default Description
enabled boolean true Master switch to enable or disable listener registration.
minSpeechIntervalMs number 1200 Minimum interval (in ms) between speech bubble notifications.
enableStatusLineStream boolean true Forward ⏵ status lines from assistant stream chunks.
enableToolEvents boolean true React to tool executions (bash, edit, write, read).
enableApprovalEvents boolean true Announce when an approval request is waiting for human permission.

Event Mappings

DSH Event OpenPets Reaction Speech Behavior
agent/status: running thinking Curated thinking speech
agent/status: idle success Curated success speech (suppressed for 5s after errors)
agent/error error Curated error speech
approval/request waiting Curated permission speech
agent/assistant-stream working Sanitized ⏵ status line
tools/result (bash) running Sanitized tool description
tools/result (edit/write) editing Sanitized file action
tools/result (read) working Sanitized read action

License

MIT

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.