MicroSpotlight
openharness-find-plugin
No description
- Stars
- 0
- Language
- TypeScript
- Created
- Aug 17, 2026
- Updated
- Aug 17, 2026
Introduction
OpenHarness Find Plugin
A DeepSeek Harness plugin that discovers plugins from the curated OpenHarness Plugins catalog.
The plugin contributes two surfaces:
openharness_find_plugins, a read-only model tool for catalog search.- Discover, a Web UI tab under Settings → Plugins with search, filters, plugin details, repository links, and an install button.
Discovery never installs code. The install button calls the explicit
window.__OPENHARNESS_PLUGIN_INSTALLER__ host contract. It remains disabled
when the host does not provide that contract.
The bridge's listInstalled() method may return package names or metadata
objects with name, packageName, repositoryUrl, and version. Discovery
only shows Installed when identity is conclusive: the exact distribution
package matches, or a canonical name is corroborated by a matching repository.
Any conflicting supplied field rejects the match, and a bare catalog name is
treated as inconclusive. Repository comparison only normalizes common git+,
.git, trailing-slash, and GitHub casing differences.
After identity is confirmed, valid semantic versions are compared. When the
catalog version is newer, the card shows the installed and target versions and
changes the action to Upgrade. The bridge receives action: "upgrade" with
the same explicit target version and catalog revision used for installation.
Install from a checkout
Build the package, then add it to the DSH Web profile:
pnpm install
pnpm build
dsh plugin --profile web add .
Catalog Git revisions include the built lib files and do not run lifecycle
build scripts during installation. This keeps pnpm's build allowlist closed in
the user's DSH profile.
Alternatively, test without changing a profile:
dsh web --patch ./cordis.patch.yml
Development
pnpm install
pnpm typecheck
pnpm test
pnpm build
The default catalog endpoint is:
https://microspotlight.github.io/openharness-plugins/catalog/v1/catalog.json
Compatibility
The initial release targets DeepSeek Harness 0.1.0-rc.6. DSH is in developer
preview, so compatibility is intentionally pinned and tested rather than
assumed across release candidates.
License
Apache License 2.0.