DeepSeek Harness Plugin

Shiro-umi/dsh-system-monitor

Stars ★ 1 Category UI Enhancements Added 2026-11-10

Composer dock monitor with 5 drag-reorderable pills (Context, Tokens, CPU, GPU, MEM): a 20x5 context brick matrix, per-turn net upload/download token bars, and 200ms native macOS Mach/IOKit scrolling charts with top-5 process lists. The native sampler is compiled on first start and needs clang (Xcode Command Line Tools); without it the charts fall back to 1-second samples.

Install

# from a prebuilt release tarball

dsh plugin --profile web add "https://github.com/Shiro-umi/dsh-system-monitor/releases/download/v0.1.0/dsh-system-monitor.tgz"

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

dsh plugin --profile web add github:Shiro-umi/dsh-system-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

Five pills in the DeepSeek Harness composer dock. Context, tokens, and live system readings share one row. Click any pill to open its card.

English · 中文

Composer dock

The five pills

Pill Live reading Card
Context 5x3 micro grid and usage percentage 20x5 brick matrix, system prompt / tool defs / messages split, cache hit rate
Tokens Net upload and download per turn Direction arrows, up/down ratio, up to 16 step bars, cache hit rate
CPU User plus system load, with a 36 s bar chart 60 s bar chart with peak line, user and system detail, top 5 processes
GPU Device utilization, with a 36 s bar chart 60 s bar chart with peak line, renderer and tiler detail, top 5 processes
MEM Used and total, with a 36 s bar chart 60 s bar chart with peak line, wired / compressed / floor rows, top 5 processes

Drag any pill to reorder. The order persists in localStorage.

Cards

One card opens at a time. Click anywhere outside to dismiss.

Install

dsh plugin --profile web add github:Shiro-umi/dsh-system-monitor

Or install the release tarball:

dsh plugin --profile web add https://github.com/Shiro-umi/dsh-system-monitor/releases/latest/download/dsh-system-monitor.tgz

Link a local checkout while developing:

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

Restart DeepSeek Harness afterward.

Requires macOS and clang (Xcode Command Line Tools). On first start the plugin compiles sampler.c into bin/sampler. When the install directory is read-only it builds into the system temp directory instead.

Sampling

Item Value
Rate One frame every 200 ms
CPU Per-core tick deltas, split into user and system
GPU IOAccelerator PerformanceStatistics
Memory vm_statistics64, same basis as top PhysMem
Transport NDJSON stream from the host
Idle stop Sampler exits 5 s after the last subscriber leaves
Orphan guard Sampler exits when the parent process is gone

Fallbacks

Condition Behavior
clang missing Frames built from top, ioreg, and sysctl once per second, LOW tag on the pill
Not macOS Native sampler off, falls back to CPU and memory from node:os
Process query fails Card shows a placeholder, metrics keep updating

Slots

The plugin takes three entries in the composer dock. It replaces the built-in usage and activity indicators with its own five pills.

Develop

npm run check
npm test

npm test verifies the manifest, export map, client static invariants, card width math, and icon geometry.

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.