DeepSeek Harness Plugin

BolunHan/cc-monitor#dsh-cc-monitor

Stars ★ 2 Downloads (30d) 1,092 Category Notifications & Integrations Added 2026-08-27 npm dsh-cc-monitor

Reports DeepSeek Harness session activity to a self-hosted cc-monitor server, which surfaces Claude Code and DSH sessions as color-coded state cards in one web dashboard and pings your browser and Android app when a session needs attention.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-cc-monitor

# from a prebuilt release tarball

dsh plugin --profile web add "https://github.com/BolunHan/cc-monitor/releases/download/v0.7.4/dsh-cc-monitor.tgz"

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

dsh plugin --profile web add github:BolunHan/cc-monitor#path:/dsh-cc-monitor

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

A host-side DSH plugin that reports session activity to a cc-monitor server. It maps DSH session events to the same normalized hook payloads the server already accepts, then POSTs them to /api/event with agent: dsh.

Install

dsh plugin --profile web add link:/path/to/cc-monitor/dsh-cc-monitor

Then make sure the profile's package.json lists dsh-cc-monitor in dsh.profile.bundles (the dsh plugin add command normally handles this for out-of-tree bundles; verify with dsh --profile web --dump-config).

First npm publish: npm Trusted Publishing can only publish subsequent versions once the package already exists. Publish the first version once from a machine with npm login (npm login && npm publish --access public), then the GitHub Actions trusted-publisher job can publish future versions.

Configuration

Defaults are designed for a local cc-monitor server on 127.0.0.1:9876. Override them with environment variables or a patch entry:

- insert:
    - id: cc-monitor
      name: 'dsh-cc-monitor'
      config:
        # Full override; host/port below are ignored when this is set.
        serverUrl: 'https://192.168.1.100:9876'
        # Or configure host + port separately:
        # host: '192.168.1.100'
        # port: 9876
        uid: 'my-dsh-instance'

If serverUrl is set, port overrides its port. If serverUrl is omitted, host + port are used to build http://<host>:<port>.

Setting Environment Default
serverUrl CC_MONITOR_URL —
host CC_MONITOR_HOST 127.0.0.1
port CC_MONITOR_PORT 9876
uid CC_MONITOR_UID dsh-default
enabled — true

How it maps

DSH event cc-monitor event State
direct user/message UserPromptSubmit working
assistant/message cached, then turn/end → Stop pending_review
tool/call PreToolUse working
approval tool call PermissionRequest pending_approval
tool/result PostToolUse working
session/disposed SessionEnd all_done

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.